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Introduction 



Sun’s Release 3.2 has many new features: 

□ Software support for the new Sun-3/1 10, Sun-3/120 , Sun-3/260, and Sun- 
3/280 systems. 

□ Introduction of System V compatibility package 

□ Enhancements for 3.0 systems 

□ Bug fixes for Release 3.0 and 3. 1 

□ This release is completely compatible with 3.0 and 3.1. Any program that 
has been developed to run under 3.0 and 3. 1 runs on 3.2. However, you have 
to recompile to take advantage of the new features. 

NOTE Some of the software that was standard in previous releases is now optional. 

More of the software in Release 3.2 can be optionally loaded through Setup 
This will allow a user to load only the software needed, thus freeing up more 
space on local disks. See Appendix C for a complete list of optional 
software. 

Installing Unix on the Sun Workstation for Release 3.2 (800-1521) 

System V Enhancements Overview (800-1541) 

Writing Device Driver Manual (800-1304) 

Commands Reference Manual for the Sun Workstation (800-1295) 

Unix Interface Reference Manual (800-1303) 

SunView Programmer’ s Guide (800-1345) 

SunView System Programmer s Guide (800-1342) 

Sun System Diagnostics Manual (800-1529) 

Floating Point Programmer’ s Guide for the Sun Workstation (800-1552) 



1.1. Supporting 
Documentation 
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1.2. Documentation The following conventions are used in the procedures and examples throughout 

conventions this document: 

□ What the system types at you is printed in typewriter font like 
this. 

□ What you type at the system is shown in boldface typewriter 
font like this. Every thing shown in boldface should be typed 
exactly as it appears. 

□ Where parts of a command are shown in italic text like this , they refer to a 
variable which you have to substitute from a selection; it is up to you to 
make the proper substitution. 
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2.1. Introduction 
Purpose 



3.2 Release Upgrade Installation 



In this chapter, we guide you through the 3.2 upgrade. Because there were some 
small shipments of earlier software released under 3.2pilot, 3.2 beta, and 
3. 2+ ex tendons, it is necessary to make the following distinctions for those users 
who might be running these earlier releases: 



3.0 fcs= 3.0 
3.2 fcs= 3.2 

3.2 pilots 3.2 pilot version 
3.2 beta= 3.2 beta version 

3.2 +extensions= 3.2pilot + Sun-3/260 patch tape software 

Any users running the software shipped with this release will be running the 
final version of the 3.2 release software (3.2 fcs). 

The upgrade procedures are designed to upgrade systems currently running 
3.0/cs, 3.2 pilot or 3.2+ extensions releases only. 

NOTE If you are currently running release 3.1, you must install Release 3.2 using 

Setup. See Installing Unix on the Sun Workstation (800-1521) for complete 
details. 

This upgrade procedure supports the following configurations: 

□ Standalone machines with local tape drive and disk(s). 

□ Standalone machines with disk(s) but without local tape drive. 

□ Homogeneous servers with local tape drive and disk(s). 

□ Homogeneous servers with disk(s) but without local tape drive. 

□ Heterogeneous servers with local tape drive and disk(s). 

□ Heterogeneous servers with disk(s) but without local tape drive. 

Please read through this chapter a few times and familiarize with the procedures 
before you start the upgrade. 
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Terminology 



Requirements For Each 
Configuration 



In this section, we define some of the specific terms that are used in this chapter. 
We assume that you have some experience in installing UNIX on a Sun Worksta- 
tion. If you do not understand some of the instructions or terms in this chapter, 
refer to Installing UNIX on the Sun Workstation and the System Administration 
Manual for the Sun Workstation for details. 

Tape host: The system with the tape drive is called the tape host. 

Homogeneous Server: A server that supports clients of its own architecture. 

Heterogeneous Server: A server that supports both MC68010 and MC68020 
clients. 



In this section, we list the requirements of each configuration that the upgrade 
procedures support You MUST meet all the requirements of your configuration 
in order to upgrade your system. Upgrading with a remote tape drive is slower 
than upgrading with a local tape drive. Unless these is no other choice, upgrade 
with a local tape drive is highly recommended. Client partitions that are com- 
mented out in /etc/nd.local on a server will not be upgraded. Refer to section 2.4 
of this chapter for instructions on how to upgrade these partitions. A client that 
boots a special kernel from its root partition will be upgraded with the 3.2 fcs 
GENERIC kernel in its root partition after the upgrade. If you want that client to 
boot the kernel that it ran before the upgrade, there are three steps you need to 
follow: 

□ Make sure there are no compatibility problems. 

□ Copy the kernel to your home directory before the upgrade. 

□ Move the kernel back to the client root partition after the upgrade and before 
you bring up the client system. 

If you wish the client to boot a special 3.2 kernel, configure a new kernel after 
the upgrade and move it to the client root partition before you bring up the client 
system. 

The following upgrade walkthroughs are provided in this chapter: 

1. Standalone System With Local Tape Drive 

□ Standalone system running 3.0, 3.2 pilot or 3.2* extensions with local tape 
drive 

2. Standalone System With Remote Tape Drive 

□ Standalone system running 3.0, 3.2 pilot, or 3.* extensions. 

□ The tape host must be reachable from the standalone system through the eth- 
emet. The tape host and the standalone system must be on the same network. 

□ /etc/hosts of a standalone system must contain the internet address of 
the tape host whether or not yp is running. 

□ / et c / ho s t s of the tape host must contain the internet address of the stan- 
dalone system if yp is not running. If yp is running, the / et c / ho s t s file 
on the master yp server must contain the internet address of the standalone 
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system. 

□ / . r ho st s of the tape host must contain the name of the standalone system 

□ The standalone system must be able to boot the FCS version of miniroot 
from a server on the same network with same architecture as the standalone 
system. This server can be the tape host or another server on the same net- 
work. 



The FCS version of miniroot requires 5 M of disk space from the server’s 
I pub. Put the miniroot under the server’s /pub. Create a symbolic link under 
liftpboot if the standalone system is a Sun-3 machine. Boot the miniroot 
from server. See Appendix B of Installing Unix on the Sun Workstation. 

3. Homogeneous Server With Local Tape Drive 

□ Homogeneous server running 3.0, 3.2pilot, or 3. 2+ extensions with local tape 
drive 

4. Homogeneous Server With Remote Tape Drive 

□ Homogeneous server running 3.0, 3.2 pilot, or 3. 2+ extensions 

□ The tape host must be reachable from the homogeneous server through the 
ethemet. The tape host and the homogeneous server must be on the same 
network. 

□ /etc / hosts of homogeneous server must contain the internet address of 
the tape host whether or not yp is running. 

□ /etc / hosts of the tape host must contain the internet address of the 
homogeneous server if yp is not running. If yp is running, the 
/etc/hosts file on the master yp server must contain the internet address 
of the standalone system. 

□ / . rho st s of the tape host must contain the name of the homogeneous 
server 

□ Homogeneous server must be able to boot the FCS version of the miniroot 
from a server on the same network with same architecture as the homogene- 
ous server. This server can be the tape host or another server on the same 
network. 



The FCS version of miniroot requires 5 M of disk space from server’s 
/pub. Put the miniroot under server’s /pub. Create a symbolic link under 
/tftpboot if the standalone system is a Sun-3 machine. Boot the miniroot 
from the server. See Appendix B of Installing Unix on the Sun Workstation 
for more details. 

5. Heterogeneous Server With Local Tape Drive 

□ Heterogeneous server running 3.0, 3.2 .pilot, or 3.2+ extensions with local 
tape drive 

□ Make sure each client mounts a user file system of its own architecture from 
the server. A MC680 10 client uses the server’ s /usr.MC 68010 file. A 
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MC68020 client uses the server’s /usr . MC68020 file. Make sure 
/etc/f stab file for each client partition contains the correct information. 

6. Heterogeneous Server With Remote Tape Drive 

□ Heterogeneous server running 3.0, 3.2pilot, or 3. 2+ extensions 

□ The tape host must be reachable from the heterogeneous server through the 
ethemet. The tape host and the heterogeneous server must be on the same 
network. 

□ /etc/hosts of the heterogeneous server must contain the internet address 
of the tape host whether or not yp is running. 

□ / et c / ho s t s of tape host must contain the internet address of the hetero- 
geneous server if yp is not running. If yp is running, the /etc/hosts file 
on the master yp server must contain the internet address of the standalone 
system. 

□ / . r ho st s of tape host must contain the name of the heterogeneous server. 

□ Heterogeneous server must be able to boot the FCS version of the miniroot 
from a server on the same network with same architecture as the heterogene- 
ous server. This server can be the tape host or another server on the same 
network. 

The FCS version of the miniroot requires 5 M of disk space from the 
server’s /pub. Put the miniroot under the server’s I pub. Create a symbolic 
link under Itftpboot if the standalone system is a Sun-3 machine. Boot the 
miniroot from server. See Appendix B of Installing Unix on the Sun Works- 
tation for more details 

□ Make sure each client mounts a user file system of its own architecture from 
the server. A MC68010 client uses the server’s /usr.MC68010 file. A 
MC68020 client uses the server’ s /usr. MC68020 file. Make sure 

/ et c / f s t ab file for each client partition contains the correct information. 
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Table 2-1 System Sizes without Optional Software 



System 


Size 


Standalone System 


(D 


5707K 


(/usr) 


1365 IK 


Homogeneous Server 


(!) 


1695K 


(/pub) 


4012K 


(/usr) 


1365 IK 


Heterogeneous Server 


(D 


1695K 


(/ pubMC68010 ) 


4012K 


(/pubMC68020) 


4012K 


( lusrMC68010 ) 


1365 IK 


(/usr MC68020) 


1365 IK 



NOTE Each client root partition requires at least 1661 Kbytes. 

2.2. Upgrade Overview 1 . Login to the system and use the df{\) command to display information about 

the space available in each file system. All optional software currently exist- 
ing on the disk(s) will automatically be loaded with the latest version. The 
upgrade procedure will ask if you wish to load any optional software which 
does not exist on the disk(s). If you wish to load additional software, you 
MUST make sure the file systems have enough space available BEFORE 
you start the upgrade. Use the table below to figure out the space require- 
ments on your disks. If there is not enough space to load additional 
software, it is recommended that you run Setup to reinstall your system with 
adequate disk space. See Installing Unix on the Sun Workstation^ 800-1521) 
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Table 2-2 Optional Software Space Requirements 



Optional Software 


Size 


Networking 


2320K (/usr) 


Debugging 


1041K (/usr) 


Suntools users 


1940K (/usr) 


Suntools programmers 


2269K (/usr) 


Suntools source 


40 IK (/usr) 


Text processing 


80 IK (/usr) 


Setup 


957K (/usr) 


Standjdiag 


4K (/pub) 4K (/usr) 


Fortran 


837K (/usr) 


Usr_diag 


1538K (/usr) 


Graphics 


2860K (/usr) 


Pascal 


998K (/usr) 


Profiled 


879K (/usr) 


Uucp 


5K(/) 536K (/usr) 


System V 


3518K (/usr) 


Man 


4510K (/usr) 


Demo 


2270K (/usr) 


Games 


2494K (/usr) 


Vtroff 


6028K (/usr) 



2. Full backups are strongly recommended before you start the upgrade. 
Remember to halt all clients before the backups if the system is a server. 
Users’ home directories on the disk will not be touched by the upgrade pro- 
cedure. Therefore, you can copy the files you want to save on the disk to 
your home directory and restore the files after the upgrade. 

/usr / lib/ sendmail . cf will not be touched. The copy of 
/usr/lib/sendmail . cf that currently exists on the disk will be saved 
and be used after the upgrade. Earlier versions of the mail configuration files 
are compatible with 3.2 fcs. If you wish to use the latest version of the mail 
configuration file, refer to the Communications Chapter of the System 
Administration Manual for detailed instructions. 

3. Become superuser and halt your system. You need to make sure all clients 
are halted before you halt the system if the system is a server. 

host# /etc/halt 

4. If you are upgrading the system with a remote tape drive, skip this step and 
go to the next step (step 5). If you are upgrading the system with a local tape 
drive, boot the general purpose bootstrap program from the tape by typing 
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’b’ followed by two character device abbreviation for your tape drive type, 
and open and closed parentheses. 

>b tape ( ) 

Table 2-3 Tape Devices 



Devices 


Description 


ar 


Archive quarter-inch tape cartridge 


mt 


Nine-track magnetic 1/2" tape-Tapemaster controller 


St 


SCSI tape controller cartridge 


xt 


Nine-track magnetic 1/2" tape-Xylogics 472 controller 



5. Load the minimal subset of UNIX call "miniroot" onto your disk. All 

upgrade software resides on this miniroot. If you are upgrading with a local 
tape drive, do the following: 

Boot: tape (0,0, 4) 

Standalone Copy 
From: tape (0,0, 5) 

To: dM(0, 0, 1) 



Table 2-4 Disk Devices 



Devices 


Description 




Xylogics 440/450/45 1 SMD disk controller 


sd 


SCSI disk controller 


ip 


Interphase disk controller (Sun-2 only) 



If you are upgrading with a remote tape drive, do the following: 



>b ethernet ( 0 , serverhost ) stand/copy 
From: ethernet (0, serverhost, pub#) miniroot 
To: disk (0,0,1) 



Table 2-5 Ethernet Types 



Type 


Description 


ec 


3COM ethernet controller 


ie 


Sun-2 ethernet controller 


le 


Sun-3 ethernet controller 



serverhost is the host number of the server, which has the bootable FCS version 
of miniroot, in hexadecimal representation. Refer to the section Requirements for 
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Each Configuration in the beginning of this chapter. 

The pub# is 0 if the system you are upgrading is Sun-2 and 1 if the system you 
are upgrading is Sun-3. 

6. Boot the miniroot from your disk. 

Boot : disk (0,0,1) vraunix -as 

root device ? diskO* 



7. When the system is up and displays a # prompt, make sure the date is 
correct. Now change your working directory to /usr/etc/upgrade. 

# cd /usr/etc/upgrade 

Start the upgrade procedure by typing the following command: 

# UPGRADE 



8. Specify the type of the system. 

Enter system type ? [standalone | server] : 

If the system is a server, you need to specify whether it 
is a homogeneous server or a heterogeneous server. 

Enter server type ? [homo | heter] : 

9. Specify whether the upgrade will be done with a local tape drive or remote 
tape drive. If you are upgrading the system with a remote tape drive, make 
sure you meet all the requirements specified in the last section. 

Enter tape drive type ? [local | remote] : 



If you are upgrading the system with a remote tape drive, you also need to 
specify the name of the tape host and the ethemet type of your system. 
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Enter host of remote drive ? 

Enter ethernet type of this system ? [ec | ie | le] 
See Table 2-5. 

10. Specify abbreviation of tape device. 

Enter tape type ? [ar | st | mt | xt] : 

See Table 2-3. 



11. Specify whether the system is running yellow pages or not. 

Enter yp type of machine? [master | slave I client 
I none] : 



12. Specify the disk partition where the root file system resides. 

Enter root disk partition for the MC680x0 architec- 
ture (e.g. xyOa) ? 

13. Specify the list of optional software to be loaded. If the system is a hetero- 
geneous server, you need to specify the list of optional software to be loaded 
for both MC68010 and MC68020 architectures. Optional software currently 
existing on the disk will be automatically loaded. Optional software 
currently not existing on the disk will be prompted for your attention. 



Select optional software for the MC680x0 architecture : 



Do 


you 


want 


to 


install 


"Networking"? [y/n] 


: 


Do 


you 


want 


to 


install 


"Debugging"? [y/n] : 




Do 


you 


want 


to 


install 


"Suntools_users"? [y/n] : 


Do 


you 


want 


to 


install 


"Suntools_j?rogrammers"? [y/n] 


Do 


you 


want 


to 


install 


"Suntools source"? 


[y/n] : 


Do 


you 


want 


to 


install 


" Text_pr oces s ing" ? 


[y/n] : 


Do 


you 


want 


to 


install 


"Setup"? [y/n] : 




Do 


you 


want 


to 


install 


"Stand_diag"? [y/n] 


: 


Do 


you 


want 


to 


install 


"Fortran"? [y/n] : 




Do 


you 


want 


to 


install 


"Usr_diag"? [y/n] : 




Do 


you 


want 


to 


install 


"Graphics"? [y/n] : 




Do 


you 


want 


to 


install 


"Pascal"? [y/n] : 




Do 


you 


want 


to 


install 


"Profiled"? [y/n] : 




Do 


you 


want 


to 


install 


"Uucp”? [y/n] : 




Do 


you 


want 


to 


install 


"System_V"? [y/n] : 




Do 


you 


want 


to 


install 


"Man"? [y/n] : 




Do 


you 


want 


to 


install 


"Demo"? [y/n] : 




Do 


you 


want 


to 


install 


"Games"? [y/n] : 




Do 


you 


want 


to 


install 


"Vtroff"? [y/n] : 
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14. UPGRADE saves some of the administrative files from the release the system 
is currently mnning for upgrade purpose. If you answer ’y’, UPGRADE will 
remove these old files after UPGRADE is completed. If you answer ’n’, 
UPGRADE will leave these old files on the disk after UPGRADE is com- 
pleted. Since you won’t be needing these files after the upgrade and they 
take some disk space, it is recommended that you answer ’y ’ to remove these 
files after the upgrade. 

Do you want to remove files saved from 3.0FCS after the upgrade ? [y/n]: 
or 

Do you want to remove files saved from 3.2PILOT after the upgrade? [y/n]: 



15. The upgrade procedure is about to begin. If you entered information 

incorrectly, you can answer ’n’ and restart by going back to step 7. If you are 
ready to start the upgrade, answer ’y’ and you will be prompted for attention 
only when tape needs to be changed. 

Are you ready to start the upgrade ? [y/n] : 

NOTE Below is the upgrade procedure for a Sun-3 standalone system called godzilla 
which was running 3.0fcs before the upgrade. All optional software is chosen to 
be loaded in this example. 



Beginning 3.0FCS to 3.2FCS upgrade for the MC68020 architecture. 

Saving administrative files from 3.0FCS : 

Start preserving godzilla' s files. 

All done preserving files. 

Changing directory to 

Extracting "root" files from ”/dev/nrmtO” release tape. 

[ This takes approximately 2 1/2 minutes with mt/xt and 
approximately 2 1/2 minutes with ar/st. ] 

Extracting "pub" files from "/dev/nrmtO" release tape. 

[ This takes approximately 3 minutes with mt/xt and 
approximately 7 minutes with ar/st. ] 

Changing directory to "/usr”. 

Extracting "sys" files from "/dev/nrmtO" release tape. 

[ This takes approximately 8 minutes with mt/xt and 
approximately 12 minutes with ar/st. ] 

Extracting "user" files from "/dev/nrmtO" release tape. 
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[ This takes approximately 14 minutes with mt/xt and 
approximately 15 minutes with ar/st. ] 

Extracting "Networking" files from "/dev/nrmtO" release tape. 

[ This takes approximately 5 minutes with mt/xt and 
approximately 4 minutes with ar/st. ] 

Extracting "Debugging" files from "/dev/nrmtO" release tape. 

[ This takes approximately 3 minutes with mt/xt and 
approximately 3 1/3 minutes with ar/st. ] 

Extracting "Suntools_users” files from "/dev/nrmtO" release tape. 

[ This takes approximately 4 1/2 minutes with mt/xt and 
approximately 3 5/6 minutes with ar/st. ] 

Extracting "Suntools_prograimiers" files from "/dev/nrmtO" release tape. 

[ This takes approximately 2 1/2 minute with mt/xt and 
approximately 4 1/4 minutes with ar/st. ] 

Extracting "Suntools_source" files from "/dev/nrmtO" release tape. 

[ This takes approximately 2 1/2 minutes with mt/xt and 
approximately 3 minutes with ar/st. ] 

Extracting "Text_processing" files from "/dev/nrmtO" release tape. 

[ This takes approximately 2 minute with mt/xt and 
approximately 3 minutes with ar/st. ] 

Extracting "Setup" files from "/dev/nrmtO" release tape. 

[ This takes approximately 1 1/2 minutes with mt/xt and 
approximately 3 1/2 minutes with ar/st. ] 

Extracting "Stand_diag" files from ”/dev/nrmtO" release tape. 

[ This takes approximately 1 1/2 minutes with mt/xt and 
approximately 3 minutes with ar/st. ] 

Extracting "Fortran" files from "/dev/nrmtO" release tape. 

[ This takes approximately 2 minute with mt/xt and 
approximately 3 minutes with ar/st. ] 

Extracting "Usr_diag" files from "/dev/nrmtO" release tape. 

[ This takes approximately 3 minute with mt/xt and 
approximately 5 minutes with ar/st. ] 
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Extracting "Graphics" files from " /dev/nrmtO" release tape. 

[ This takes approximately 4 minutes with mt/xt and 
approximately 5 minutes with ar/st. ] 

Extracting "Pascal" files from "/dev/nrmtO" release tape. 

[ This takes approximately 4 minutes with mt/xt and 
approximately 4 minutes with ar/st. ] 

Extracting "Profiled" files from "/dev/nrmtO" release tape. 

[ This takes approximately 2 minutes with mt/xt and 
approximately 5 minutes with ar/st. ] 

Extracting "Uucp" files from "/dev/nrmtO" release tape. 

[ This takes approximately 2 minute with mt/xt and 
approximately 5 minutes with ar/st. ] 

Extracting "System_V" files from "/dev/nrmtO" release tape. 

[ This takes approximately 5 minutes with mt/xt and 
approximately 6 minutes with ar/st. ] 

Extracting "Man" files from "/dev/nrmtO" release tape. 

[ This takes approximately 15 minutes with mt/xt and 
approximately 17 minutes with ar/st. ] 

Extracting "Demo" files from "/dev/nrmtO" release tape. 

[ This takes approximately 2 minute with mt/xt and 
approximately 4 minutes with ar/st. ] 

Extracting "Games" files from "/dev/nrmtO" release tape. 

[ This takes approximately 2 minutes with mt/xt and 
approximately 5 minutes with ar/st. ] 

Extracting "Vtroff" files from "/dev/nrmtO" release tape. 

[ This takes approximately 4 minutes with mt/xt and 
approximately 8 minutes with ar/st. ] 

Restoring administrative files from 3.0FCS release : 

Start restoring godzilla's files. 

All done restoring files. 

Removing administrative files from 3.0FCS release : 

Start cleaning godzilla's files. 

All done cleaning files. 
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Checking filesystems : 

/dev/rxyOa: 516 files, 2575 used, 4896 free (16 frags, 610 blocks) 
/dev/rxyOg: 1678 files, 18810 used, 39733 free (69 frags, 4958 blocks) 
3.0FCS to 3.2FCS upgrade completed. 

Reboot your system and configure a kernel for your system. 

# 

15. Abort the system by typing ’Ll -A’ or hit <break>. 

16. Boot system kernel from the disk by typing 

>b 

17. Reconfigure a kernel for your system. Refer to Chapter 3 for details. 



2.3. Example Upgrade This section contains example upgrade walkthroughs for the following system 

Walkthroughs configurations: 

□ Standalone System with a Local Tape Drive 

□ Standalone System with a Remote Tape Drive 

□ Homogeneous Server with a Local Tape Drive 

□ Homogeneous Server with a Remote Tape Drive 

□ Heterogeneous Server with a Local Tape Drive 

□ Heterogeneous Server with a Remote Tape Drive 



Upgrade A Standalone System Assume the standalone system has a local 1/2" tape drive (mt) and the system is 

with a Local Tape Drive running 3.2pilot. Below is a list of the optional software that currently exists on 

the disk: 

Suntoolsusers 

Suntoolssource 

Fortran 

Pascal 

Profiled 

Man 

Suntools_programmers 



>b mt ( ) 

Boot: mt(,,4) 

From: mt(,,5) 

To: xy(,,l) 

Boot: xy (, , 1) vmunix -as . 



root device ? xyO* 
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# 

# cd /usr/etc/upgrade 

# UPGRADE 

Enter system type ? [standalone | server] : standalone 
Enter tape drive type ? [local | remote] : local 
Enter tape type ? [ar | st | mt | xt] : mt 

Enter yp type for machine? [master | slave | client | none] : client 

Enter root disk partition for the MC68020 architecture (e.g. xyOa) ? 
/dev/rxyOa: 516 files, 2575 used, 4896 free (16 frags, 610 blocks) 
/dev/rxyOg: 1678 files, 18810 used, 39733 free (69 frags, 4958 blocks) 



Select 


optional 


. software for the MC68020 architecture : 


Do 


you 


want 


to 


install 


"Debugging”? [y/n] : 


y 


Do 


you 


want 


to 


install 


"Text processing"? 


[y/n] : y 


Do 


you 


want 


to 


install 


"Setup"? [y/n] : y 




Do 


you 


want 


to 


install 


"Stand diag"? [y/n] 


: y 


Do 


you 


want 


to 


install 


"Usr_diag"? [y/n] : 


y 


Do 


you 


want 


to 


install 


"Graphics"? [y/n] : 


y 


Do 


you 


want 


to 


install 


"Uucp"? [y/n] : y 




Do 


you 


want 


to 


install 


"System_V"? [y/n] : 


y 


Do 


you 


want 


to 


install 


"Demo"? [y/n] : y 




Do 


you 


want 


to 


install 


"Games"? [y/n] : y 




Do 


you 


want 


to 


install 


"Vtroff”? [y/n]: y 




Do 


you 


want 


to 


remove files saved from 3.2PILOT after the upgrade ? [y/n]: y 



Are you ready to start the upgrade ? [y/n] : y 

Beginning 3.2PILOT to 3.2FCS upgrade for the MC68020 architecture. 

Saving administrative files from 3.2PILOT : 

Start preserving godzilla's files. 

All done preserving files. 

Changing directory to "/". 

Extracting "root" files from "/dev/nrmtO" release tape. 

Extracting "pub" files from "/dev/nrmtO" release tape. 

Changing directory to ”/usr". 

Extracting "sys" files from "/dev/nrmtO" release tape. 

Extracting "user" files from "/dev/nrmtO" release tape. 
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Extracting "Networking" files from "/dev/nrmtO" release tape. 



Extracting "Vtroff" files from "/dev/nrmtO" release tape. 

Restoring administrative files from 3.2PILOT release : 

Start restoring godzilla's files. 

All done restoring files. 

Removing administrative files from 3.2PILOT release : 

Start cleaning godzilla's files. 

All done cleaning files. 

Checking filesystems : 

/dev/rxyOa: 516 files, 2575 used, 4896 free (16 frags, 610 blocks) 
/dev/rxyOg: 1678 files, 18810 used, 39733 free (69 frags, 4958 blocks) 

3.2PILOT to 3.2FCS upgrade completed. 

Reboot your system and configure a kernel for your system. 

# 



Upgrade A Standalone System Assume the host number of the system we are booting from is 1 14. 1 14 in 

With Remote Tape Drive decimal is equal to 72 in hexidecimal. We have a Sun-3 machine and it is run- 

ning 3.0/cs(3.0). Therefore, the pub number is 1. Below is a list of the optional 
software that currently exists on the disk: 

Suntoolsusers 

Suntoolssource 

Fortran 

Pascal 

Profiled 

Man 

>b ie(,72)boot -a 
Boot : ie ( , 72) stand/copy 
From: ie (, 72, 1) miniroot 
To: xy(,,l) 

Boot: xy (, , 1) vraunix -as 



root device ? xyO* 
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# 

# cd /usr/etc/upgrade 

# UPGRADE 

Enter system type ? [standalone | server] : standalone 
Enter tape drive type ? [local | remote] : remote 
Enter host of remote drive ? pebbles 

Enter ethernet type of this system ? [ec | ie | le] : ie 
Enter tape type ? [ar | st | mt | xt] : st 

Enter yp type for machine? [master | slave | client | none] : none 

Enter root disk partition for MC68020 architecture (e.g xyOa) ? 

/dev/rxyOa: 516 files, 2575 used, 4896 free (16 frags, 610 blocks) 
/dev/rxyOg: 1678 files, 18810 used, 39733 free (69 frags, 4958 blocks) 

Select optional software for the MC68020 architecture : 

Do you want to install "Stand_diag"? [y/n] : y 
Do you want to 



Do you want to install "System_V"? [y/n] : y 
Do you want to install "Demo"? [y/n] : y 
Do you want to install "Games"? [y/n] : y 
Do you want to install "Vtroff"? [y/n] : y 

Do you want to remove files saved from 3.0FCS after the upgrade ? [y/n]: y 
Are you ready to start the upgrade ? [y/n] : y 

Beginning 3.0FCS to 3.2FCS upgrade for the MC68020 architecture. 

Saving administrative files from 3.0FCS : 

Start preserving godzilla's files. 

All done preserving files. 

Changing directory to "/". 

Extracting "root" files from "/dev/nrmtO" release tape. 

Extracting "pub" files from "/dev/nrmtO" release tape. 

Changing directory to "/usr". 

Extracting "sys" files from "/dev/nrmtO" release tape. 

Extracting "user" files from "/dev/nrmtO" release tape. 
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Extracting "Debugging" files from "/dev/nrmtO" release tape. 



Extracting "Vtroff" files from "/dev/nrmtO" release tape. 

Restoring administrative files from 3 . OFCS release : 

Start restoring godzilla's files. 

All done restoring files. 

Removing administrative files from 3. OFCS release : 

Start cleaning godzilla's files. 

All done cleaning files. 

Checking filesystems : 

/dev/rxyOa: 516 files, 2575 used, 4896 free (16 frags, 610 blocks) 
/dev/rxyOg: 1678 files, 18810 used, 39733 free (69 frags, 4958 blocks) 

3. OFCS to 3.2FCS upgrade completed. 

Reboot your system and configure a kernel for your system. 

# 



Upgrade A Homogeneous Assume we have a server called godzilla with three Sun-3 clients : frodo, grendel 

Server With Local Tape Drive and sofia. In this case, all 3.0 optional software exists on the disk. 

>b mt ( ) 

Boot: 

From: mt(,,5) 

To: xy(,,l) 

Boot: xy (, , 1) vmunix -as 



root device ? xyO* 



# 

# cd /usr/etc/upgrade 

# UPGRADE 



Enter system type ? [standalone | server] : server 

Enter server type ? [homo | heter] : homo 

Enter tape drive type ? [local | remote] : local 
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Enter tape type ? [ar | st | mt | xt] : mt 

Enter yp type for machine? [master | slave | client | none] : slave 

Enter root disk partition for MC68020 architecture (e.g. xyOa) ? 

/dev/rxyOa: 516 files, 2575 used, 4896 free (16 frags, 610 blocks) 
/dev/rxyOh: 1678 files, 18810 used, 39733 free (69 frags, 4958 blocks) 
/dev/rxyOf: 83 files, 3495 used, 840 free (18 frags, 104 blocks) 

Select optional software for the MC68020 architecture: 

Do you want to install "System V"? [y/n] : y 

Do you want to remove files saved from 3.0FCS after the upgrade ? [y/n]: y 
Are you ready to start the upgrade ? [y/n] : y 

Beginning 3.0FCS to 3.2FCS upgrade for the MC68020 architecture. 



Saving administrative files from 3.0FCS : 

Start preserving frodo' s files. 

Start preserving grendel's files. 

Start preserving Sofia's files. 

Start preserving godzilla' s files. 

All done preserving files. 

Changing directory to "/" . 

Extracting "root" files from "/dev/nrmtO" release tape. 
Changing directory to "/pub". 



Extracting "pub" files from "/dev/nrmtO" release tape. 

Beginning 3.0FCS to 3.2FCS upgrade on MC68020 diskless clients. 

Beginning 3.0FCS to 3.2FCS upgrade on client frodo. 

[ Ignore this message: tar: can't create ./lib/: No such file or directory 

Restoring adm files for client frodo : 

Start restoring frodo' s files. 

All done restoring files. 

Completed 3.0FCS to 3.2FCS upgrade on client frodo. 

Beginning 3.0FCS to 3.2FCS upgrade on client grendel. 

[ Ignore this message: tar: can't create ./lib/: No such file or directory 

Restoring adm files for client grendel : 

Start restoring grendel's files. 

All done restoring files. 
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Completed 3.0FCS to 3.2FCS upgrade on client grendel. 

Beginning 3.0FCS to 3.2FCS upgrade on client Sofia. 

[ Ignore this message: tar: can't create ./lib/: No such file or directory ] 

Restoring adm files for client sofia : 

Start restoring Sofia's files. 

All done restoring files. 

Completed 3.0FCS to 3.2FCS upgrade on client sofia. 

Changing directory to "/usr". 

Extracting "sys" files from "/dev/nrmtO" release tape. 

Extracting "user" files from "/dev/nrmtO" release tape. 

Extracting "Networking" files from "/dev/nrmtO” release tape. 

Extracting "Debugging" files from "/dev/nrmtO" release tape. 



Extracting "Vtroff" files from "/dev/nrmtO" release tape. 

Restoring administrative files from 3.0FCS release : 

Start restoring godzilla' s files. 

All done restoring files. 

Removing administrative files from 3 . OFCS release : 

Start cleaning frodo's files. 

Start cleaning grendel' s files. 

Start cleaning Sofia's files. 

Start cleaning godzilla' s files. 

All done cleaning files. 

Checking filesystems : 

/dev/rxyOa: 516 files, 2575 used, 4896 free (16 frags, 610 blocks) 
/dev/rxyOh: 1678 files, 18810 used, 39733 free (69 frags, 4958 blocks) 
/dev/rxyOf: 83 files, 3495 used, 840 free (18 frags, 104 blocks) 

3. OFCS to 3.2FCS upgrade completed. 

Reboot your system and configure a kernel for your system. 

# 
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Upgrade A Homogeneous 
Server With Remote Tape 
Drive 



Assume the host number of the system we are booting from is 1 14. 1 14 in 
decimal is equal to 72 in hexidecimal. We have a Sun-3 machine and the system 
is running 3.0 + extensions. Therefore, the pub number is 1. In this case, none of 
the optional software exists on the disk. 

>b i.e(,72)boot -a 
Boot : ie ( , 72) stand/ copy 
From: ie (, 72, 1) mini root 
To: xy(,,l) 

Boot: xy (, , 1) vznunix -as 



root device ? xyO* 



# 

# cd /usr/etc/upgrade 

# UPGRADE 



Enter system type ? [standalone | server] : server 

Enter server type ? [homo | heter] : homo 

Enter tape drive type ? [local | remote] : remote 



Enter host of remote drive ? pebbles 



Enter ethernet type of this system ? [ec | ie | le] : ie 



Enter tape type ? [ar | st | mt | xt] : mt 

Enter yp type for machine? [master | slave | client | none] : client 

Enter root disk partition for MC68020 architecture (e.g. xyOa) ? 

/dev/rxyOa: 516 files, 2575 used, 4896 free (16 frags, 610 blocks) 
/dev/rxyOh: 1678 files, 18810 used, 39733 free (69 frags, 4958 blocks) 
/dev/rxyOf: 83 files, 3495 used, 840 free (18 frags, 104 blocks) 



Select optional software for the MC68020 architecture : 
Do you want to install "Suntools_users"? [y/n] : y 
Do you want to install "Suntools_prograrrmers"? [y/n] : y 
Do you want to install ,, Suntools_source ,, ? [y/n] : y 
Do you want to install "Stand_diag"? [y/n] : y 
Do you want to install "Fortran"? [y/n] : y 
Do you want to install "Usr_diag"? [y/n] : y 
Do you want to install "Graphics"? [y/n] : y 
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Do 


you 


want 


to 


install 


"Pascal"? [y/n] : y 


Do 


you 


want 


to 


install 


"Profiled"? [y/n] : y 


Do 


you 


want 


to 


install 


"Uucp”? [y/n] : y 


Do 


you 


want 


to 


install 


"System_V"? [y/n] : y 


Do 


you 


want 


to 


install 


"Man"? [y/n] : y 


Do 


you 


want 


to 


install 


"Demo"? [y/n] : y 


Do 


you 


want 


to 


install 


"Games"? [y/n] : y 


Do 


you 


want 


to 


install 


"Vtroff"? [y/n] : y 


Do 


you 


want 


to 


remove : 


files saved from 3 .2+extensions after the upgrade 



Are you ready to start the upgrade ? [y/n] : y 

Beginning 3 . 2+extensions to 3.2FCS upgrade for the MC68020 architecture. 

Saving administrative files from 3 . OFCS : 

Start preserving frodo's files. 

Start preserving grendel's files. 

Start preserving Sofia's files. 

Start preserving godzilla' s files. 

All done preserving files. 

Changing directory to "/". 

Extracting "root" files from "/dev/nrmtO" release tape. 

Changing directory to "/pub". 

Extracting "pub" files from "/dev/nrmtO" release tape. 

Beginning 3 .2+extensions to 3.2FCS upgrade on MC68020 diskless clients. 
Beginning 3 .2+extensions to 3.2FCS upgrade on client frodo. 

[ Ignore this message: tar: can't create ./lib/: No such file or directory ] 



Restoring adm files for client frodo : 

Start restoring frodo's files. 

All done restoring files. 

Completed 3 .2+extensions to 3.2FCS upgrade on client frodo. 

Beginning 3 .2+extensions to 3.2FCS upgrade on client grendel. 

[ Ignor this message: tar: can't create ./lib/: No such file or directory ] 



Restoring adm files for client grendel : 

Start restoring grendel's files. 

All done restoring files. 

Completed 3 . 2+extensions to 3.2FCS upgrade on client grendel. 



Beginning 3 .2+extensions to 3.2FCS upgrade on client sofia. 
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[ Ignore this message: tar: can't create ./lib/: No such file or directory ] 

Restoring adm files for client sofia : 

Start restoring Sofia's files. 

All done restoring files. 

Completed 3 . 2+extensions to 3.2FCS upgrade on client sofia. 

Changing directory to "/usr". 

Extracting "sys" files from "/dev/nrmtO” release tape. 

Extracting "user" files from "/dev/nrmtO" release tape. 

Extracting "Networking" files from "/dev/nrmtO" release tape. 

Extracting "Debugging" files from "/dev/nrmtO" release tape. 



Extracting "Vtroff" files from "/dev/nrmtO" release tape. 

Restoring administrative files from 3 . 2+extensions release : 

Start restoring godzilla's files. 

All done restoring files. 

Removing administrative files from 3 . 2+extensions release : 

Start cleaning frodo' s files. 

Start cleaning grendel's files. 

Start cleaning Sofia's files. 

Start cleaning godzilla's files. 

All done cleaning files. 

Checking filesystems : 

/dev/rxyOa: 516 files, 2575 used, 4896 free (16 frags, 610 blocks) 
/dev/rxyOh: 1678 files, 18810 used, 39733 free (69 frags, 4958 blocks) 
/dev/rxyOf: 83 files, 3495 used, 840 free (18 frags, 104 blocks) 

3 .2+extensions to 3.2FCS upgrade completed. 

Reboot your system and configure a kernel for your system. 

# 



Upgrade A Heterogeneous Assume we have a server called godzilla with two Sun-3 clients (frodo and gren- 

Server With Local Tape Drive del) and one Sun-2 client (sofia). In this case we assume that none of the 

optional software from both architectures exists on the disk. 



>b mt ( ) 

Boot: 

From: mt(,,5) 
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To: xy(,,l) 

Boot: xy ( , , 1) vmunix -as 



root device ? xyO* 



# 

# cd /usr/etc/upgrade 

# UPGRADE 

Enter system type ? [standalone | server] : server 
Enter server type ? [homo | heter] : heter 
Enter tape drive type ? [local | remote] : local 
Enter tape type ? [ar | st | mt | xt] : mt 

Enter yp type for machine? [master | slave | client | none] : slave 

Enter root disk partition for the MC68020 architecture (e.g. xyOa) ? 

/dev/rxyOa: 516 files, 2575 used, 4896 free (16 frags, 610 blocks) 
/dev/rxyOh: 1678 files, 18810 used, 39733 free (69 frags, 4958 blocks) 
/dev/rxyOf: 83 files, 3495 used, 840 free (18 frags, 104 blocks) 
/dev/rxyOg: 1163 files, 18150 used, 40393 free (73 frags, 5040 blocks) 
/dev/rxyOe: 83 files, 3574 used, 905 free (17 frags. 111 blocks) 



Select 


optional software for the MC68020 


architecture 


Do 


you 


want 


to 


install 


”Suntools_users" ? 


[y/n] : y 


Do 


you 


want 


to 


install 


"Suntools programmers"? [y/n] : 


Do 


you 


want 


to 


install 


"Suntools source"? 


1 [y/n] : y 


Do 


you 


want 


to 


install 


”Stand_diag"? [y/n] : y 


Do 


you 


want 


to 


install 


"Fortran"? [y/n] : 


y 


Do 


you 


want 


to 


install 


"Usr diag"? [y/n] : 


y 


Do 


you 


want 


to 


install 


"Graphics”? [y/n] : 


y 


Do 


you 


want 


to 


install 


"Pascal"? [y/n] : y 




Do 


you 


want 


to 


install 


"Profiled"? [y/n] : 


y 


Do 


you 


want 


to 


install 


"Uucp"? [y/n] : y 




Do 


you 


want 


to 


install 


"System V"? [y/n] : 


y 


Do 


you 


want 


to 


install 


"Man"? [y/n] : y 




Do 


you 


want 


to 


install 


"Demo"? [y/n] : y 




Do 


you 


want 


to 


install 


"Games"? [y/n] : y 




Do 


you 


want 


to 


install 


"Vtroff”? [y/n] : y 


r 


Select 


optional software for the MC68010 


architecture 


Do 


you 


want 


to 


install 


"Suntools users"? 


[y/n] : y 
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Do you want to install ,, Suntools_progralTmers ,, ? [y/n] : y 

Do you want to install "Suntools_source"? [y/n] : y 

Do you want to install "Stand_diag"? [y/n] : y 

Do you want to install "Fortran"? [y/n] : y 

Do you want to install "Usr_diag"? [y/n] : y 

Do you want to install "Graphics"? [y/n] : y 

Do you want to install "Pascal"? [y/n] : y 

Do you want to install "Profiled"? [y/n] : y 

Do you want to install "Uucp"? [y/n] : y 

Do you want to install "System_V"? [y/n] : y 

Do you want to install "Man"? [y/n] : y 

Do you want to install "Demo"? [y/n] : y 

Do you want to install "Games"? [y/n] : y 

Do you want to install "Vtroff"? [y/n] : y 

Do you want to remove files saved from 3.0FCS after the upgrade ? [y/n] : y 
Are you ready to start the upgrade ? [y/n] : y 

Beginning 3.0FCS to 3.2FCS upgrade for the MC68020 architecture. 

Saving administrative files from 3.0FCS : 

Start preserving frodo's files. 

Start preserving grendel' s files. 

Start preserving Sofia's files. 

Start preserving godzilla's files. 

All done preserving files. 

Changing directory to "/". 

Extracting "root" files from "/dev/nrmtO" release tape. 

Changing directory to "/pub". 

Extracting "pub" files from "/dev/nrmtO” release tape. 

Beginning 3.0FCS to 3.2FCS upgrade on MC68020 diskless clients. 

Beginning 3.0FCS to 3.2FCS upgrade on client frodo. 

[ Ignore this message: tar: can't create ./lib/: No such file or directory ] 

Restoring adm files for client frodo : 

Start restoring frodo's files. 

All done restoring files. 

Completed 3.0FCS to 3.2FCS upgrade on client frodo. 

Beginning 3.0FCS to 3.2FCS upgrade on client grendel. 

[ Ignore this message: tar: can't create ./lib/: No such file or directory ] 
Restoring adm files for client grendel : 
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Start restoring grendel's files. 

All done restoring files. 

Completed 3.0FCS to 3.2FCS upgrade on client grendel. 
Changing directory to "/usr". 

Extracting "sys" files from "/dev/nrmtO" release tape. 
Extracting "user" files from "/dev/nrmtO" release tape. 
Extracting "Networking" files from "/dev/nrmtO" release tape. 
Extracting "Debugging" files from "/dev/nrmtO" release tape. 



Extracting "Vtroff" files from "/dev/nrmtO" release tape. 

Beginning 3.0FCS to 3.2FCS upgrade for the MC68010 architecture. 

Changing directory to "/pub .MC68010" . 

Extracting "pub" files from "/dev/nrmtO" release tape. 

Beginning 3.0FCS to 3.2FCS upgrade on MC68010 diskless clients. 

Beginning 3.0FCS to 3.2FCS upgrade on client sofia. 

[ Ignore this message: tar: can't create ./lib/: No such file or directory ] 

Restoring adm files for client sofia : 

Start restoring Sofia's files. 

All done restoring files. 

Completed 3.0FCS to 3.2FCS upgrade on client sofia. 

Changing directory to "/usr .MC68010" . 

Extracting "sys" files from "/dev/nrmtO" release tape. 

Extracting "user" files from "/dev/nrmtO" release tape. 

Extracting "Networking" files from "/dev/nrmtO" release tape. 

Extracting "Debugging" files from "/dev/nrmtO" release tape. 
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Extracting "Vtroff" files from "/dev/nrmtO" release tape. 

Restoring administrative files from 3.0FCS release : 

Start restoring godzilla's files. 

All done restoring files. 

Removing administrative files from 3.0FCS release : 

Start cleaning frodo's files. 

Start cleaning grendel's files. 

Start cleaning Sofia's files. 

Start cleaning godzilla's files. 

All done cleaning files. 

Checking filesystems : 

/dev/rxyOa: 516 files, 2575 used, 4896 free (16 frags, 610 blocks) 
/dev/rxyOh: 1678 files, 18810 used, 39733 free (69 frags, 4958 blocks) 
/dev/rxyOf: 83 files, 3495 used, 840 free (18 frags, 104 blocks) 
/dev/rxyOg: 1163 files, 18150 used, 40393 free (73 frags, 5040 blocks) 
/dev/rxyOe: 83 files, 3574 used, 905 free (17 frags. 111 blocks) 

3.0FCS to 3.2FCS upgrade completed. 

Reboot your system and configure a kernel for your system. 

# 



Upgrade A Heterogeneous 
Server With Remote Tape 
Drive 



>b ie(,72)boot -a 
Boot : ie ( , 72 ) stand/ copy 
From: ie (, 72, 1) miniroot 
To: xy(,,l) 

Boot: xy , 1) vraunix -as 



Assume the host number of the system we are booting from is 1 14. 1 14 in 
decimal is equal to 72 in hexidecimal. We have a Sun-3 machine. Therefore, the 
pub number is 1. In this case, we assume none of the optional software from 
both architectures exists on the disk. 



root device ? xyO* 



# 

# cd /usr/etc/upgrade 

# UPGRADE 

Enter system type ? [standalone | server] : server 
Enter server type ? [homo | heter] : heter 
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Enter tape drive type ? [local | remote] : remote 
Enter host of remote drive ? pebbles 

Enter ethernet type of this system ? [ec | ie | le] : ie 
Enter tape type ? [ar | st | mt | xt] : st 

Enter yp type for machine? [master | slave | client | none] : slave 

Enter root disk partition for the MC68020 architecture (e.g. xyOa) ? 

/dev/rxyOa: 516 files, 2575 used, 4896 free (16 frags, 610 blocks) 
/dev/rxyOh: 1678 files, 18810 used, 39733 free (69 frags, 4958 blocks) 
/dev/rxyOf: 83 files, 3495 used, 840 free (18 frags, 104 blocks) 
/dev/rxyOg: 1163 files, 18150 used, 40393 free (73 frags, 5040 blocks) 
/dev/rxyOe: 83 files, 3574 used, 905 free (17 frags. 111 blocks) 

Select optional software for the MC68020 architecture : 

Do you want to install "Suntools_users"? [y/n] : y 

Do you want to install "Suntools_prograrrmers"? [y/n] : y 

Do you want to install "Suntools_source"? [y/n] : y 

Do you want to install "Stand_diag"? [y/n] : y 

Do you want to install "Fortran"? [y/n] : y 

Do you want to install "Usr_diag"? [y/n] : y 

Do you want to install "Graphics"? [y/n] : y 

Do you want to install "Pascal"? [y/n] : y 

Do you want to install "Profiled"? [y/n] : y 

Do you want to install "Uucp"? [y/n] : y 

Do you want to install "System_V"? [y/n] : y 

Do you want to install "Man"? [y/n] : y 

Do you want to install "Demo"? [y/n] : y 

Do you want to install "Games"? [y/n] : y 

Do you want to install "Vtroff"? [y/n] : y 

Select optional software for the MC68010 architecture : 

Do you want to install "Suntools_users"? [y/n] : y 

Do you want to install "Suntools_progranmers"? [y/n] : y 

Do you want to install "Suntools_source"? [y/n] : y 

Do you want to install "Stand_diag"? [y/n] : y 

Do you want to install "Fortran"? [y/n] : y 

Do you want to install "Usr_diag"? [y/n] : y 

Do you want to install "Graphics"? [y/n] : y 

Do you want to install "Pascal"? [y/n] : y 

Do you want to install "Profiled"? [y/n] : y 

Do you want to install "Uucp"? [y/n] : y 

Do you want to install "System_V"? [y/n] : y 

Do you want to install "Man"? [y/n] : y 

Do you want to install "Demo"? [y/n] : y 

Do you want to install "Games"? [y/n] : y 

Do you want to install "Vtroff"? [y/n] : y 

Do you want to remove files saved from 3.0FCS after the upgrade ? [y/n]: y 
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Are you ready to start the upgrade ? [y/n] : y 

Beginning 3.0FCS to 3.2FCS upgrade for the MC68020 architecture. 

Saving administrative files from 3.0FCS : 

Start preserving frodo's files. 

Start preserving grendel's files. 

Start preserving Sofia's files. 

Start preserving godzilla's files. 

All done preserving files. 

Changing directory to "/" . 

Extracting "root" files from "/dev/nrstO" release tape. 

Changing directory to "/pub". 

Extracting "pub" files from "/dev/nrstO" release tape. 

Beginning 3.0FCS to 3.2FCS upgrade on MC68020 diskless clients. 

Beginning 3.0FCS to 3.2FCS upgrade on client frodo. 

[ Ignore this message: tar: can't create ./lib/: No such file or directory ] 

Restoring adm files for client frodo : 

Start restoring frodo's files. 

All done restoring files. 

Completed 3.0FCS to 3.2FCS upgrade on client frodo. 

Beginning 3.0FCS to 3.2FCS upgrade on client grendel. 

[ Ignore this message: tar: can't create ./lib/: No such file or directory ] 

Restoring adm files for client grendel : 

Start restoring grendel's files. 

All done restoring files. 

Completed 3.0FCS to 3.2FCS upgrade on client grendel. 

Changing directory to "/usr". 

Extracting "sys" files from "/dev/nrstO" release tape. 

Extracting "user" files from "/dev/nrstO" release tape. 

Extracting "Networking" files from "/dev/nrstO" release tape. 

Extracting "Debugging" files from "/dev/nrstO" release tape. 
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Extracting "Vtroff" files from "/dev/nrstO" release tape. 

Beginning 3.0FCS to 3.2FCS upgrade for the MC68010 architecture. 

Changing directory to "/pub.MC68010" . 

Extracting "pub" files from "/dev/nrstO" release tape. 

Beginning 3.0FCS to 3.2FCS upgrade on MC68010 diskless clients. 

Beginning 3.0FCS to 3.2FCS upgrade on client sofia. 

[ Ignore this message: tar: can't create ./lib/: No such file or directory ] 

Restoring adm files for client sofia : 

Start restoring Sofia's files. 

All done restoring files. 

Completed 3.0FCS to 3.2FCS upgrade on client sofia. 

Changing directory to "/usr .MC68010" . 

Extracting "sys" files from "/dev/nrstO" release tape. 

Extracting "user" files from "/dev/nrstO" release tape. 

Extracting "Networking" files from "/dev/nrstO" release tape. 

Extracting "Debugging" files from "/dev/nrstO" release tape. 



Extracting "Vtroff" files from "/dev/nrstO" release tape. 

Restoring administrative files from 3.0FCS release : 

Start restoring godzilla's files. 

All done restoring files. 

Removing administrative files from 3.0FCS release : 

Start cleaning frodo' s files. 

Start cleaning grendel's files. 

Start cleaning Sofia's files. 

Start cleaning godzilla's files. 

All done cleaning files. 

Checking filesystems : 

/dev/rxyOa : 516 files, 2575 used, 4896 free (16 frags, 610 blocks) 
/dev/rxyOh : 1678 files, 18810 used, 39733 free (69 frags, 4958 blocks) 
/dev/rxyOf : 83 files, 3495 used, 840 free (18 frags, 104 blocks) 
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/dev/rxyOg: 1163 files, 18150 used, 40393 free (73 frags, 5040 blocks) 
/dev/rxyOe: 83 files, 3574 used, 905 free (17 frags, 111 blocks) 



3.0FCS to 3.2FCS upgrade completed. 

Reboot your system and configure a kernel for your system. 
# 



2.4. How To Upgrade A This section explains how you can upgrade a partition to 3.2 fcs software that was 

Client Partition To not upgraded to 3.2 fcs during the upgrade of the server. Here is a sample 

3.2 fcs /etc/nd.local file : 

# 

# These lines added by the Sun Setup Program 

# 

clear 
version 1 

user 0 1 /dev/xyOf 0 11960 -1 
user clientl 0 /dev/xyOc 50600 10120 0 
user clientl 1 /dev/xyOc 60720 39560 -1 
#user client2 0 /dev/xyOc 100280 10120 1 
#user client2 1 /dev/xyOc 110400 39560 -1 
user client3 0 /dev/xyOc 149960 10120 2 
user client3 1 /dev/xyOc 160080 39560 -1 
son 
# 

# End of lines added by the Sun Setup Program 

# 



The Steps to Upgrade Client2 
to 3.2 fcs. 



1 . Make sure /etc/hosts on the server contains the internet address of 
client2. You need to make sure /etc/hosts on the yp master contains 
the internet address of client2 if you are running yellow pages. 

2. Make sure /etc/ethers on the server contains the ethemet address of 
client2. You need to make sure /etc/ethers on the yp master contains 
the ethemet address of client2 if you are running yellow pages. 

3. Fix /etc/nd.local by removing ’#’ from these two lines. 



#user client2 0 /dev/xyOc 100280 10120 1 
#user client2 1 /dev/xyOc 110400 39560 -1 

4. Run nd. 

server# /etc/nd < /etc/nd.local 

5. Mount client partition. 

server# mount /dev/ndll /mnt 
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6. Go to the client partition. 

server# cd /mnt 

7. Save all administrative files from the current release. 

server# cp .login .login. save 

server# cp .cahrc . cshrc.save 

server# cp .rhosts . rhosts.save 

server# cp etc/passwd etc/passwd. save 

server# cp etc/printcap etc/print cap. save 

server# cp etc/fstab etc/f stab. save 

server# cp etc/host b . equiv etc/hosts .equiv. save 

server# cp etc/hosts etc/hosts . save 

server# cp etc/rc. local etc/rc . local . save 

server# cp etc/rc. boot etc/rc. boot . save 

server# cp private/usr/lib/crontab private/usr/lib/crontab. save 
server# cp private/usr/lib/sendmail.cf private/usr/lib/sendmail.cf .save 

8. Mount tape #1 of release tape to the tape drive. 

9. Position tape to the right file on the release tape. 

server# mt -f /dev/nrtapeO fsf 8 

Refer to Table 2-3 for tape devices. 

10. Extract files from the tape. 

server# tar xvpf /dev/nrtapeO 
server# mt -f /dev/nrtapeO rew 

Refer to Table 2-3 for tape devices. 

11. Restore all administrative files by comparing the files saved and the new 
files and merge them by hand. 

12. Get out of the client partition. 

server# cd / 

13. Unmount the client partition. 

server# umount /dev/ndll 



2.5. How To Restart The If for any reason UP GRADE terminated before it was completed, you can restart 

Upgrade Procedures the upgrade procedure depending on the state of the system. Here are some 

suggestions. Please do not try these suggestions unless you fully understand the 
instructions. 

1. If UPGRADE terminated before you saw this message on the console: 

Extracting "root" files from "/dev/nrtape" release tape. 
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On the console, do the following: 

□ make sure you are still in the miniroot 

□ make sure no file systems are mounted. 

□ # cd /usr/etc/upgrade 

□ # UPGRADE 

2. If UPGRADE terminated after you saw this message 

Extracting "root" files from "/dev/nrtape" release tape. 

On the console, do the following: 

□ make sure you are still in the miniroot 

□ make sure root and user file systems are mounted to /a and /a/usr 

□ go through all files under /a, /a/etc and /a/private/usr/lib 
ending with " . save" and make sure the files contain correct information. If 
the files do not contain correct information and you do not know how to 
recover the files, you will not be able to continue with the upgrade procedure 
and you will have to use Setup to rebuild your system from scratch. 

□ Make sure / a/usr/ sys /conf /RELEASE contains the release number 
of the system before you started the upgrade (3.0FCS or 3.2PILOT) 

□ If your system is a server, you need to go through each client partition to 
make sure all files contain correct information for the partition. 

□ If the files are correct, run these commands: 

# cd usr/etc/upgrade 

# adm_tool restore name machinetype yptype release 

Usage: adm_tool op name machinetype yptype release 
where: 

op = save, restore or clean 
name = name to be performed the operation 
machinetype = standalone, server or diskless 
yptype = master, slave, client or none 
release = 3.0FCS or 3.2PILOT 

□ If the system is a server, go through each partition and do the following: 

# mkdir /a/client 

# mount /dev/ndl# /a/client 

# cd /a/client 

# /usr/etc/upgrade/adm_tool restore client_name diskless yptype release 

# cd / 

# umount /dev/ndl# 
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Replace with a positive integer 

□ unmount root and user file systems 

□ make sure no file systems are mounted 

□ # cd /usr/etc/upgrade 

□ # UPGRADE 
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Reconfiguring Your Kernel 



You do NOT have to reconfigure your kernel because a GENERIC kernel is now 
provided on the upgrade tape. However, we recommend that you reconfigure 
your kernel in order to save space or to customize your kernel to recognize your 
hardware. You can do so by using the following procedure. You must reboot your 
system whether you reconfigure or not. 

If you are doing kernel configuration for the first time, you can use the pro- 
cedures in 

Installing UNIX on the Sun Workstation 

(Part Number: 800-1521). 

If you have previously configured a kernel, you can use the following sections to 
guide you through reconfiguration. The first subsection gives reconfiguration 
procedures for standalone machines, the second subsection addresses servers, and 
the third subsection is an annotated copy of the new GENERIC kernel 
configuration file; read it carefully to make sure you are including the correct 
device description lines for your system. The last two sections of this chapter 
contain specific GENERIC files for a Sun-2 or Sun-3 machine. 

NOTE See General and Specific System Description Lines sections of Installing Unix on 
the Sun Workstation/or more detailed information concerning the Annotated 
GENERIC file. 



Kernel Reconfiguration for 
Standalone Systems 



For standalone machines, proceed as follows. 

1 . Change the current directory to / sys/conf : 

# cd /sys/conf 

2. Create a kernel configuration file. 

Copy the file GENERIC and comment out the lines that don’t apply to your 
system. We’ll call the new file SYS_NAME (the name of the system). For 
example, 

# Cp GENERIC SYS_NAME 

# chxnod +w SYS_NAME 
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3. Edit / sy s/ conf /SYS_NAME to reflect your system configuration. Use the 
annotated copy of GENERIC provided in the following section for an expla- 
nation of these changes. Make sure you are including the proper device 
description lines for your system. 

4. Still in the /sy si conf directory, run / etclconfig . Then change directory to the 
new configuration directory, and make the new system (remember to substi- 
tute your actual system image name for SYS NAME): 

# /etc/config SYS NAME 

# Cd . . / SYS_NAME 

# make 

[ lots of output ] 

5. Now you can save your old kernel and install your new one: 

# mv /vmunix /vmunix.old 

# cp vmunix /vmunix 

# /etc/ shutdown -h now 

The system goes through the halt sequence, then 
the monitor displays its prompt, at which point you 
can boot the system: 

> b vmunix 

6. If the system appears to work, this completes the upgrade procedure. If the 
new kernel doesn’t seem to be functioning properly, boot /vmunix.old , copy 
it back to /vmunix , and go about fixing your new kernel: 

# /etc/shutdown -h now 

> b vmunix.old -s 

# mv /vmunix /vmunix. oops 

# mv /vmunix.old /vmunix 

# ~D [ Brings the system up multi-user ] 



Kernel Reconfiguration for 
Servers 



For server machines, proceed as follows. 

1. Change the current directory to Isys/conf: 

# cd /sys/conf 

2. Create a kernel configuration file. 

Copy the file GENERIC and comment out the lines that don’t apply to your 
system. We’ll call the new file SYSJNAME (the name of the system). For 
example, 

# cp GENERIC SYS_NAME 

# chmod +w SYS_NAME 

3. Edit / sys/conf/ SYS _NAME to reflect your system configuration. Use the anno- 
tated copy of GENERIC provided in the next section for an explanation of 
these changes. Make sure you include the proper device description lines for 
your system. 
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4. Still in the /sys/conf directory, run /etc/config. Then change to the new 
configuration directory, and make the new system (remember to substitute 
your actual system image name for SYS NAME): 

# /etc/config SYS_NAME 

# Cd . . / SYSNAME 

# make 

[ lots of output ] 

5. Now prepare a kernel for your clients in the same way. When editing the 
configuration file (called CLIENT KERNEL NAME in the following), remember 
to include the entire set of devices used by all the machines: 

# cd /usr .MCclientarch/ sys/conf 

# Cp TEMPLATE NAME CUENT_KERNEL_NAME 

# chxnod +W CLIENT KERNEL NAME 

[ Edit CUENT KERNEL NAME to reflect all clients’ systems. 

Be especially careful with the device description lines. ] 

# /etc/config CLIENTJKERNELNAME 

# Cd . . / CLIENT JCERNELNAME 

# make 

[ lots of output ] 

6. Now you can position yourself in the directory which has the server’s kernel 
in it, save your server’s old kernel, install your new one, and try everything 
out: 

# cd /usr/sys/ SYS _NAME 

# mv /vmunix / vmunix . old 

# cp vmunix /vmunix 



7. Next, install the appropriate client kernel in /pub for the architecture.. To 
install the clients’ kernel, make sure all the clients are halted, save the ori- 
ginal kernel (if there is one), install the new kernel image in /pub, and then 
test it out by booting up one of the clients: 

# cd /usr. MCclientarch/ sys / CLIENT JCERNEL_NAME 
[or wherever your client kernel is] 

# mv vmunix /pub/vmunix 

[ On the client machine : ] 

>b vmunix 



8. Since at this point normal system performance is a highly, but not abso- 
lutely, certain indicator of a trouble-free kernel, if your system(s) appears to 
work you may proceed with some confidence. You have successfully com- 
pleted installation. Congratulations! 



If, on the other hand, either of the new kernels does not seem to be function- 
ing properly, halt all systems and boot from the original kernel. Then move 
the faulty kernel away and re-install the original in its place. Once you are 
booted up on the original, you can go about trying to fix the faulty kernel. 



sun 

microsystems 



Revison A of 10 October 1986 





46 Release 3.2 Manual for the Sun Workstation 



Kernel Reconfiguration 
Annotated Copy of a 
GENERIC File 



For example, on the server: 

# /etc/halt 

> b vmunix.old -s 

# cd / 

# mv vmunix vxminix.bad 

# mv vmunix.old vmunix 

# ~D [ Brings the system up multi-user ] 

For clients, halt all the clients on the server. You will have to correct the prob- 
lem from the server. 

On the server: 

# cd /pub . MCclient_arch 

# mv vmunix vmunix. bad 

# mv vmunix.old vmunix 

You may now boot up the clients and allow them to run while or until a new 
client kernel is made and ready to install; or if the clients can remain down, build 
and install a new client kernel now. 



— an The following is an EXAMPLE of an annotated copy of a GENERIC file to help 
you identity the lines you need to include in your own system configuration file. 



NOTE For the specific GENERIC files for a Sun-2 or Sun-3 machine, see Section 3.1 
(Sun-2) or Section 3.2 (Sun-3) of this chapter. 

The comments explain the device and pseudo-device lines, and may also refer 
you to the reference manual entry which covers the device in question. If the 
comments say the line is mandatory, the line must be included in every system 
configuration file, either exactly as it stands, or, if commentary indicates vari- 
ables, with the variables adjusted to fit your system. 

NOTE A number of parameters relating to the System V Inter-Process Communication 
(IPC) extensions may also be tuned in the configuration file. These parameters 
do not appear in the GENERIC file but are documented in the System V Over- 
view. 
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NOTE * You need not include all machine types, only the machine type(s) that you may 
be running. 



Configuration Line 

# 

# GENERIC SUN-3 

41 


Comments 


Description 


it 

machine 


" sun3" 


mandatory 


Identifies the specific machine 


cpu 


" SUN3_160" 


mandatory* 


Identifies the specific CPU type (Sun-3/160, Sun-3/180, or Sun-3/75) 


cpu 


" SUN3_50" 


mandatory* 


Identifies the specific CPU type 


cpu 


" SUN3__2 60" 


mandatory* 


Identifies the specific CPU type (Sun-3/260 or Sun-3/280) 


cpu 


" SUN3_110" 


mandatory* 


Identifies the specific CPU type (Sun-3/ 110 


ident 


GENERIC 


mandatory 


See General and Specific System Description Lines for information. Finally, 
if SYS_NAME contains both alpha and numeric characters alpha and numeric 
characters (as in, for example, SDST120), you must enclose the name in 
double quotes ("SDST120") or you will get a syntax error when you run 
letc/config. 


timezone 


s 8 dst 


mandatory 


Specifies your timezone. Adjust value accordingly. Can also use half hour 
designations. 


maxusers 


! 4 


mandatory 


Number may vary. For most systems, “4” is the proper value for 
maxusers. See the section General System Description Lines for informa- 
tion. 


options 


INET 


mandatory 


Controls inclusion of Internet code — see inet{ 4). You must also include 
the “pseudo-device loop” lines below. 


options 


SYSACCT 


optional 


Controls inclusion of code to do process accounting — see acct (2) and 
acct (5). 


options 


QUOTA 


optional 


Controls the disk quota checking system. 


options 


NFS 


optional 


Inclusion of NFS code. 


options 


NIT 


optional 


Inclusion of network interface tap code 


options 


IPCMESSAGE 


optional 


Controls inclusion of code for SystemV IPC Message Facility. 


options 


IPCSEMAPHORE 


optional 


Controls inclusion of code for SystemV IPC Semaphore Facility. 


options 


IPCSHMEM 


optional 


Controls inclusion of code for SystemV IPC Shared-Memory Facility. 



config vmunix swap generic mandatory Specify kernel name and configuration clauses. Pleases ee Specific System 

Description Lines for information. 



pseudo-device pty optional Pseudo-tty’s. Needed for network or window system, 

pseudo-device bk optional Berknet line discipline for high speed tty input — see bk( 4). 

pseudo-device ether optional ARP code. Must include if using Ethernet — see arp (4). 

pseudo-device loop mandatory Software loop back network device driver — see lo (4). Must include with 

‘options INET’. 

pseudo-device nd optional Network disk. Necessary for servers and diskless clients, and for machines 

serving as remote hosts for remote installation — see nd (4). 

pseudo-device winl28 optional Window system. Number indicates maximum windows. If you include this 

line, you must also include the “pseudo-device dtop”, “ms”, and “kb” 
lines just below. 

pseudo-device dtop4 optional Maximum number of screens (‘desktops’). Required for window system, 

pseudo-device ms 3 optional Maximum number of mice. Required for window system — see ms (4). 
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pseudo-device kb3 optional Maximum number of Sun keyboards. Required if using any Sun keyboard, 

and for the window system. 

The following are connections for machine types. These connections, in conjunction with controllers, devices, and 
disks for a structure that enable your system to recognize various hardware and software attached to it. For each dev- 
ice or controller on a bus, you need to have the bus type it is connected to listed under connections for machine type. 
It easiest to leave all lines for machine types that way as you add controllers and devices the connections are already 
in place and will be recognized by your system. 



# connections for machine type type 1 (SUN3_160) 



controller 

controller 

controller 

controller 

controller 

controller 

controller 

controller 

controller 



virtual 1 at nexus ? 
obmem 1 at nexus ? 
obio 1 at nexus ? 
vmel6dl6 1 at nexus ? 
vme24dl6 1 at nexus ? 
vme32dl6 1 at nexus ? 
vmel6d32 1 at nexus ? 
vme24d32 1 at nexus ? 
vme32d32 1 at nexus ? 



# connections for machine type type 2 (SUN3_50) 



controller 

controller 

controller 



virtual 2 at nexus ? 
obmem 2 at nexus ? 
obio 2 at nexus ? 



# connections for machine type 3 (SUN3_260) 



controller 

controller 

controller 

controller 

controller 

controller 

controller 

controller 

controller 



virtual 3 at nexus ? 
obmem 3 at nexus ? 
obio 3 at nexus ? 
vmel6dl6 3 at nexus ? 
vme24dl6 3 at nexus ? 
vme32dl6 3 at nexus ? 
vmel6d32 3 at nexus ? 
vme24d32 3 at nexus ? 
vme32d32 3 at nexus ? 



# connections for machine type type 4 (SUN31 10) 



controller 

controller 

controller 

controller 

controller 

controller 

controller 

controller 

controller 



virtual 4 at nexus ? 
obmem 4 at nexus ? 
obio 4 at nexus ? 
vmel6dl6 4 at nexus ? 
vme24dl6 4 at nexus ? 
vme32dl6 4 at nexus ? 
vmel6d32 4 at nexus ? 
vme24d32 4 at nexus ? 
vme32d32 4 at nexus ? 



The following are controllers and devices (devices, disks, and tapes) that connect to bus types. Bus types and devices 
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must hang off the appropriate controller, which in turn hangs off another controller until a configuration is formed that 
gets you to a bus type that hangs off a "nexus". On Sun system, all bus types are just considered to hang of a "nexus". 
For example: 

disk: 



xyO at xycO drive 0 

hangs off of controller: 

xycO at vmel6dl6 ? csr 0xee40 priority 2 vector xyintr 0x48 



which hangs off bus type: 



controller vmel6dl6 1 at nexus ? 



In order to determine and note what devices are present on your machine, boot the GENERIC kernel after you have 
executed Setup. If you want, you can delete those lines that pertain to devices not on your machine. Or you can 
configure your file with the devices that are on other machines that will possibly want to boot from the same kernel. 

The following is an example of controllers and devices you will find in a Sun-3 configuration file. 



NOTE It is not recommended that you remove the zs lines from the configuration file. These represent UARTS. If 
removed the system will not recognize the presence of the keyboard or serial ports. 



controller 

controller 

disk 

disk 

disk 

disk 

controller 

disk 

disk 

tape 

disk 

tape 

#disk 

controller 

controller 

disk 

disk 

tape 

disk 

tape 

#disk 

device 

device 

device 



xycO at vmel6dl6 ? csr 0xee40 priority 2 vector xyintr 0x48 

xycl at vmel6dl6 ? csr 0xee48 priority 2 vector xyintr 0x49 

xyO at xycO drive 0 

xyl at xycO drive 1 

xy2 at xycl drive 0 

xy3 at xycl drive 1 

scO at vme24dl6 ? csr 0x200000 priority 2 vector scintr 0x40 

sdO at scO drive 0 flags 0 

sdl at scO drive 1 flags 0 

stO at scO drive 32 flags 1 

sd2 at scO drive 8 flags 0 

stl at scO drive 40 flags 1 

sfO at scO drive 8 flags 2 

siO at vme24dl6 ? csr 0x200000 priority 2 vector siintr 0x40 

siO at obio ? csr 0x140000 priority 2 

sdO at siO drive 0 flags 0 

sdl at siO drive 1 flags 0 

stO at siO drive 32 flags 1 

sd2 at siO drive 8 flags 0 

stl at siO drive 40 flags 1 

sfO at siO drive 8 flags 2 

zsO at obio ? csr 0x20000 flags 3 priority 3 
zsl at obio ? csr 0x00000 flags 0x103 priority 3 
mtiO at vmel6dl6 ? csr 0x620 flags Oxffff priority 4 
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device 

device 

device 

device 

device 

device 

controller 

controller 

tape 

tape 

controller 

controller 

tape 

tape 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 



vector mtiintr 0x88 

mtil at vmel6dl6 ? csr 0x640 flags Oxffff priority 4 
vector mtiintr 0x89 

mti2 at vmel6dl6 ? csr 0x660 flags Oxffff priority 4 
vector mtiintr 0x8a 

mti3 at vmel6dl6 ? csr 0x680 flags Oxffff priority 4 
vector mtiintr 0x8b 

ieO at obio ? csr OxcOOOO priority 3 

iel at vme24dl6 ? csr 0xe88000 priority 3 vector ieintr 0x75 
IeO at obio ? csr 0x120000 priority 3 

tmO at vmel6dl6 ? csr OxaO priority 3 vector tmintr 0x60 

tml at vmel6dl6 ? csr 0xa2 priority 3 vector tmintr 0x61 

mtO at tmO drive 0 flags 1 
mtl at tml drive 0 flags 1 

xtcO at vmel6dl6 ? csr 0xee60 priority 3 vector xtintr 0x64 

xtcl at vmel6dl6 ? csr 0xee68 priority 3 vector xtintr 0x65 

xtO at xtcO drive 0 flags 1 

xtl at xtcl drive 0 flags 1 

gponeO at vme24dl6 ? csr 0x210000 

cgtwoO at vme24dl6 ? csr 0x400000 

cgfourO at obmem 4 csr OxffOOOOOO priority 4 

bwtwoO at obmem 1 csr OxffOOOOOO priority 4 

bwtwoO at obmem 2 csr 0x100000 priority 4 

bwtwoO at obmem 3 csr OxffOOOOOO priority 4 

bwtwoO at obmem 4 csr OxffOOOOOO 

vpcO at vmel6dl6 ? csr 0x480 priority 2 vector vpcintr 0x80 

vpcl at vmel6dl6 ? csr 0x500 priority 2 vector vpcintr 0x81 

desO at obio ? csr OxlcOOOO 
fpaO at virtual ? csr OxeOOOOOOO 



3.1. Sun-2 GENERIC The following is the GENERIC configuration file for a Sun-2 system. 

Configuration File 



# 

# GENERIC SUN 2 

# 



machine 

cpu 

cpu 

ident 

time zone 

maxusers 

options 

options 

options 

options 

options 

options 

options 

options 



"sun2" 

"SUN2_120"# generic for machine type 1 (Multibus) 
"SUN2_50"# generic for machine type 2 (VMEbus) 
GENERIC 
8 dst 
4 

INET 

SYSACCT 

QUOTA 

NFS 

NIT 

IPCMESSAGE# SystemV IPC Message Facility 
IPCSEMAPHORE# SystemV IPC Semaphore Facility 
IPCSHMEM# SystemV IPC Shared-Memory Facility 



conf ig 



vmunixswap generic 
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pseudo-devicepty 

pseudo-devicebk 

pseudo-deviceether 

pseudo-deviceloop 

pseudo-devicend 

pseudo-devicewinl2 8 

pseudo-devicedtop4 

pseudo-devicems3 

pseudo-devicekb3 

# connections for machine type 1 (SUN2_120) 
controller virtual 1 at nexus ?# virtual preset 
controller obmem 1 at nexus ?# on board memory 
controller obio 1 at nexus ?# on board io 
controller mbmem 1 at nexus ?# Multibus memory 
controller mbio 1 at nexus ?# Multibus io 

# connections for machine type 2 (SUN2_50) 
controller virtual 2 at nexus ?# virtual preset 
controller obmem 2 at nexus ?# on board memory 
controller obio 2 at nexus ?# on board io 

controller vmel6 2 at nexus ?# 16 bit address VMEbus (16 bit data) 

controller vme24 2 at nexus ?# 24 bit address VMEbus (16 bit data) 

controller ipcO at mbio ? csr 0x40 priority 2 

controller ipcl at mbio ? csr 0x44 priority 2 

disk ipO at ipcO drive 0 

disk ipl at ipcO drive 1 

disk ip2 at ipcl drive 0 

disk ip3 at ipcl drive 1 

controller xycO at mbio ? csr 0xee40 priority 2 

controller xycO at vmel6 ? csr 0xee40 priority 2 vector xyintr 0x48 
controller xycl at mbio ? csr 0xee48 priority 2 

controller xycl at vmel6 ? csr 0xee48 priority 2 vector xyintr 0x49 

disk xyO at xycO drive 0 

disk xyl at xycO drive 1 

disk xy2 at xycl drive 0 

disk xy3 at xycl drive 1 

controller scO at mbmem ? csr 0x80000 priority 2 

controller scO at vme24 ? csr 0x200000 priority 2 vector scintr 0x40 

disk sdO at scO drive 0 flags 0 

disk sdl at scO drive 1 flags 0 

tape stO at scO drive 32 flags 1 

disk sd2 at scO drive 8 flags 0 

tape stl at scO drive 40 flags 1 

#disk sfO at scO drive 8 flags 2 

controller scl at mbmem ? csr 0x84000 priority 2 

disk sd2 at scl drive 0 flags 0 

disk sd3 at scl drive 1 flags 0 

tape stl at scl drive 32 flags 1 

#disk sfl at scl drive 8 flags 2 

device skyO at mbio ? csr 0x2000 priority 2 

device skyO at vmel6 ? csr 0x8000 priority 2 vector skyintr OxbO 
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device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

controller 

controller 

controller 

controller 

tape 

tape 

controller 

controller 

controller 

controller 

tape 

tape 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 



zsO at obio 1 csr 0x2000 flags 3 priority 3 
zsO at obio 2 csr 0x7f2000 flags 3 priority 3 
zsl at obmem 1 csr 0x780000 flags 0x103 priority 3 
zsl at obio 2 csr 0x7fl800 flags 0x103 priority 3 
zs2 at mbmem ? csr 0x80800 flags 3 priority 3 

zs3 at mbmem ? csr 0x81000 flags 3 priority 3 

zs4 at mbmem ? csr 0x84800 flags 3 priority 3 

zs5 at mbmem ? csr 0x85000 flags 3 priority 3 

mtiO at mbio ? csr 0x620 flags Oxffff priority 4 

mtil at mbio ? csr 0x640 flags Oxffff priority 4 

mti2 at mbio ? csr 0x660 flags Oxffff priority 4 

mti3 at mbio ? csr 0x680 flags Oxffff priority 4 

mtiO at vmel6 ? csr 0x620 flags Oxffff priority 4 
vector mtiintr 0x88 

mtil at vmel6 ? csr 0x640 flags Oxffff priority 4 
vector mtiintr 0x89 

mti2 at vmel6 ? csr 0x660 flags Oxffff priority 4 
vector mtiintr 0x8a 

mti3 at vmel6 ? csr 0x680 flags Oxffff priority 4 
vector mtiintr 0x8b 

ieO at obio 2 csr 0x7f0800 priority 3 

ieO at mbmem ? csr 0x88000 priority 3 

iel at mbmem ? csr 0x8c000 flags 2 priority 3 

iel at vme24 ? csr 0xe88000 priority 3 vector ieintr 0x75 

ecO at mbmem ? csr OxeOOOO priority 3 

eel at mbmem ? csr 0xe2000 priority 3 

tmO at mbio ? csr OxaO priority 3 

tmO at vmel6 ? csr OxaO priority 3 vector tmintr 0x60 
tml at mbio ? csr 0xa2 priority 3 

tml at vmel6 ? csr 0xa2 priority 3 vector tmintr 0x61 

mtO at tmO drive 0 flags 1 

mtl at tml drive 0 flags 1 

xtcO at mbio ? csr 0xee60 priority 3 

xtcO at vmel6 ? csr 0xee60 priority 3 vector xtintr 0x64 
xtcl at mbio ? csr 0xee68 priority 3 

xtcl at vmel6 ? csr 0xee68 priority 3 vector xtintr 0x65 

xtO at xtcO drive 0 flags 1 

xtl at xtcl drive 0 flags 1 

arO at mbio ? csr 0x200 priority 3 

arl at mbio ? csr 0x208 priority 3 

gponeO at vme24 ? csr 0x210000 

cgtwoO at vme24 ? csr 0x400000 

cgoneO at mbmem ? csr OxecOOO priority 3 

bwtwoO at obmem 1 csr 0x700000 priority 4 

bwtwoO at obio 2 csr 0x0 priority 4 

bwoneO at mbmem ? csr OxeOOOO priority 3 

vpO at mbio ? csr 0x400 priority 2 

vpcO at mbio ? csr 0x480 priority 2 

vpcO at vmel6 ? csr 0x480 priority 2 vector vpcintr 0x80 
vpcl at mbio ? csr 0x500 priority 2 

vpcl at vmel6 ? csr 0x500 priority 2 vector vpcintr 0x81 
piO at obio 1 csr 0x1800 
desO at obio 1 csr 0x1000 
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device desO at obio 2 csr 0x7fl000 

device todO at obio 1 csr 0x3800 

device todO at vme24 ? csr 0x200800 



3.2. Sun-3 GENERIC Configuration File 

The following is the GENERIC configuration file for a Sun-3 system. 



# 

# GENERIC SUN3 

# 



machine 

cpu 

cpu 

cpu 

cpu 

ident 

time zone 

maxusers 

options 

options 

options 

options 

options 

options 

options 

options 



"sun3" 

"SUN3_160 n # (Sun-3/160 or Sun-3/75 cpu) 
"SUN3_50” 

"SUN3_260"# (Sun-3/280) 
n SUN3_110"# 

GENERIC 
8 dst 
4 

INET 

SYSACCT 

QUOTA 

NFS 

NIT 

IPCME S SAGE # SystemV IPC Message Facility 
IPCSEMAPHORE# SystemV IPC Semaphore Facility 
IPCSHMEM# SystemV IPC Shared-Memory Facility 



conf ig 



vmunixswap generic 



pseudo-devicepty 

pseudo-devicebk 

pseudo-deviceether 

pseudo-deviceloop 

pseudo-devicend 

pseudo-devicewinl2 8 

pseudo-devicedtop4 

pseudo-devicems3 

pseudo-devicekb3 



# connections for machine type 1 (SUN3_160) 
controller virtual 1 at nexus ? 
controller obmem 1 at nexus ? 
controller obio 1 at nexus ? 
controller vmel6dl6 1 at nexus ? 
controller vme24dl6 1 at nexus ? 
controller vme32dl6 1 at nexus ? 
controller vmel6d32 1 at nexus ? 
controller vme24d32 1 at nexus ? 
controller vme32d32 1 at nexus ? 



# connections for machine type 2 (SUN3_50) 
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controller virtual 2 at nexus ? 
controller obmem 2 at nexus ? 
controller obio 2 at nexus ? 

# connections for machine type 3 (SUN3_260) 
controller virtual 3 at nexus ? 
controller obmem 3 at nexus ? 
controller obio 3 at nexus ? 
controller vmel6dl6 3 at nexus ? 
controller vme24dl6 3 at nexus ? 
controller vme32dl6 3 at nexus ? 
controller vmel6d32 3 at nexus ? 
controller vme24d32 3 at nexus ? 
controller vme32d32 3 at nexus ? 

# connections for machine type 4 (SUN3_110) 
controller virtual 4 at nexus ? 
controller obmem 4 at nexus ? 
controller obio 4 at nexus ? 
controller vmel6dl6 4 at nexus ? 
controller vme24dl6 4 at nexus ? 
controller vme32dl6 4 at nexus ? 
controller vmel6d32 4 at nexus ? 
controller vme24d32 4 at nexus ? 
controller vme32d32 4 at nexus ? 

controller xycO at vmel6dl6 ? csr 0xee40 priority 2 vector xyintr 0x48 

controller xycl at vmel6dl6 ? csr 0xee48 priority 2 vector xyintr 0x49 

disk xyO at xycO drive 0 

disk xyl at xycO drive 1 

disk xy2 at xycl drive 0 

disk xy3 at xycl drive 1 

controller scO at vme24dl6 ? csr 0x200000 priority 2 vector scintr 0x40 

disk sdO at scO drive 0 flags 0 

disk sdl at scO drive 1 flags 0 

tape stO at scO drive 32 flags 1 

disk sd2 at scO drive 8 flags 0 

tape stl at scO drive 40 flags 1 

#disk sfO at scO drive 8 flags 2 

controller siO at vme24dl6 ? csr 0x200000 priority 2 vector siintr 0x40 

controller siO at obio ? csr 0x140000 priority 2 

disk sdO at siO drive 0 flags 0 

disk sdl at siO drive 1 flags 0 

tape stO at siO drive 32 flags 1 

disk sd2 at siO drive 8 flags 0 

tape stl at siO drive 40 flags 1 

#disk sfO at siO drive 8 flags 2 

device zsO at obio ? csr 0x20000 flags 3 priority 3 

device zsl at obio ? csr 0x00000 flags 0x103 priority 3 

device mtiO at vmel6dl6 ? csr 0x620 flags Oxffff priority 4 

vector mtiintr 0x88 

device mtil at vmel6dl6 ? csr 0x640 flags Oxffff priority 4 

vector mtiintr 0x89 
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device 

device 

device 

device 

device 

controller 

controller 

tape 

tape 

controller 

controller 

tape 

tape 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 

device 



mti2 at vmel6dl6 ? csr 0x660 flags Oxffff priority 4 
vector mtiintr 0x8a 

mti3 at vmel6dl6 ? csr 0x680 flags Oxffff priority 4 
vector mtiintr 0x8b 

ieO at obio ? csr OxcOOOO priority 3 

iel at vme24dl6 ? csr 0xe88000 priority 3 vector ieintr 0x75 
IeO at obio ? csr 0x120000 priority 3 

tmO at vmel6dl6 ? csr OxaO priority 3 vector tmintr 0x60 

tml at vmel6dl6 ? csr 0xa2 priority 3 vector tmintr 0x61 

mtO at tmO drive 0 flags 1 
mtl at tml drive 0 flags 1 

xtcO at vmel6dl6 ? csr 0xee60 priority 3 vector xtintr 0x64 

xtcl at vmel6dl6 ? csr 0xee68 priority 3 vector xtintr 0x65 

xtO at xtcO drive 0 flags 1 

xtl at xtcl drive 0 flags 1 

gponeO at vme24dl6 ? csr 0x210000 
cgtwoO at vme24dl6 ? csr 0x400000 
cgfourO at obmem 4 csr OxffOOOOOO priority 4 
bwtwoO at obmem 1 csr OxffOOOOOO priority 4 
bwtwoO at obmem 2 csr 0x100000 priority 4 
bwtwoO at obmem 3 csr OxffOOOOOO priority 4 
bwtwoO at obmem 4 csr OxffOOOOOO 
vpcO at vmel6dl6 ? csr 0x480 priority 2 vector vpcintr 0x80 

vpcl at vmel6dl6 ? csr 0x500 priority 2 vector vpcintr 0x81 

desO at obio ? csr OxlcOOOO 
fpaO at virtual ? csr OxeOOOOOOO 
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Changes to 3.0 in Release 3.2 



4.1. Sun-3/110 Features 
Overview 



Networking Considerations 

Sun-3/110 Compatibility 
Issues 



Release 3.2 incorporates many new enhancements that update the 3.0 release. 

Release 3.2 contains support for the Sun-3/1 10. The sections that follow 
describe the system software that supports the Sun-3/ 1 10. 

The Sun-3/ 1 10 requires 3.2 system software. Its frame buffer is divided into 
three plane groups : a 1152x900x8 color buffer, an 1152x900x1 overlay (mono- 
chrome) plane, and an 1 152x900x1 enable plane. The Sun-3/1 10 frame buffer is 
also known as the cgfour frame buffer. The color of a pixel is determined by 
either the color buffer or the overlay monochrome plane in the following manner. 

The color frame buffer feeds out 8-bit deep data. If the corresponding bit of the 
enable plane is set, the overlay monochrome plane determines the pixel’s color 
(black or white). If the corresponding bit of the enable plane is not set, a color 
lookup table passes 8-bit deep intensity information (24 bits total) for the red, 
green, and blue components of that pixel, determining its color. You may notice 
that the intensity of white in the overlay monochrome plane is much stronger 
than that in the color buffer. This disparity may disappear in the future. 

The Sun-3/ 110’s functionality raises some questions regarding compatibility 
across Sun 3.x UNIX releases, including pixrects, pixwins, and SunView support. 
A general discussion is presented here. For programming specifics, you should 
refer to (1) the pixrect plane group interface described in the errata/addenda 
chapter of this document, and (2) the SunView Enhancements section of this 
document. 

If you are adding a diskless Sun-3/1 10 to a network, remember that a server and 
all its diskless clients (those depending on the server for binaries) must run the 
same revision level of software. However, this has nothing to do with NFS 
server/client relationships; files can be shared between systems not running the 
same release of software. 

The Sun-3/110 contains a frame buffer, described in cgfour (4), that is sup- 
ported by the pixrect, pixwin and SunView layers. 
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Pixrects The cgfour frame buffer driver automatically initializes the enable plane for a 

pixrect application. If a pixrect application is linked with a pre-3.2 pixrect 
library, the enable plane is automatically set to all l’s, and the overlay mono- 
chrome plane is displayed. If a pixrect application is linked with a 3.2 pixrect 
library, the enable plane is automatically set to all 0’s, and the color planes are 
displayed. 

Therefore, color applications (including grayscale) built with pre-3.2 libraries 
and header files will not run in color on a Sun-3/ 1 10; you must recompile using 
the 3.2 libraries and header files. Your applications will then access the pixrect 
support for the 8 -bit deep color buffer. 

Black-and-white applications that are built with pre-3.2 libraries and header files 
will run on a Sun-3/ 1 10; you should be able to move these pre-3.2 binaries onto a 
3.2 kernel and run them directly. If you do recompile, your application may run 
somewhat slower, since the auto-initialization feature will have set the applica- 
tion to run in the color planes. You can improve performance by making a 
source code change instructing your applications to use the overlay monochrome 
plane; this is discussed in the following. (For pixwins and SunView applications, 
you should make a different source code change, which is discussed under 
Pixwins.) 

As mentioned earlier, for all applications, after recompiling with 3.2, the pixrect 
returned from pr_open (”/ dev/ fb") orpr_open ("/dev/cgf ourO”) 
accesses the color buffer. To speed up monochrome applications you may set the 
pixrect to run in the overlay monochrome plane instead of the color buffer with 
the following code: 

# include <pixrect / pr_j?lanegroups . h> 
char groups [PIXPG_OVERLAY+l] ; 

pr_available_plane_groups (pr, sizeof (groups) , groups) 

if (groups [PIXPG_OVERLAY] && groups [PIXPG_OVERLAY_ENABLE] ) { 

pr_set_plane_group (pr, PIXPG_OVERLAY_ENABLE) ; 

pr_rop(pr, 0, 0, pr->pr_width, pr->pr_height , PIX_SET, 0, 0, 0); 
pr_set_j?lane_group (pr, PIXPG_OVERLAY) ; 



If the pixrect pr does not have an overlay monochrome plane, this code will do 
nothing. In a future release, Sun may provide a function to set the pixrect to run 
in the overlay monochrome plane. 

When you have made this source code change and then run a pixrect application, 
your workstation screen will flash, briefly displaying the color planes before 
switching to the overlay monochrome plane. This is due to the auto-initialization 
of the enable plane. 

To summarize, the following table outlines how a pixrect application, without the 
previous pixrect source code change, will operate when moved onto the cgfour: 
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Pixwins 



Table 4-1 Pixrect Applications on a cgfour 





Applications Linked with 
Pre-3.2 Library 


Applications Linked with 
3.2 Library 


Black and 
White 


Will use overlay plane 


Will use color planes; 
make source code change 
to use overlay plane 


Color or 
Grayscale 


Will use overlay plane; 
recompile to use color 
planes 


Will use color planes 



Note to pixrect programmers: pixrects now has a new plane group interface that 
will support cgfour’ s multiple plane architecture. This interface is described in 
the errata/addenda chapter of this document. Specifically for the cgfour frame 
buffer, pr_available_plane_groups returns 

5 ( P IXP G_OVERLAY + 1) 

and fills in groups with 

{ 0 , 0 , 1 , 1 , 1 } 

if it is at least five bytes long. 

Anything you build with SunView or SunWindows uses pixwins. Pixwins differ 
from pixrects in that pixwins do not allow applications to have direct control of 
plane groups. Instead, the pixwin library utilizes the different plane groups for 
its own purposes. In particular, the pixwin library attempts to place monochrome 
windows in the overlay monochrome plane and color windows in the color 
buffer. 

Pixwin operation on a Sun-3/ 1 10 parallels that of pixrects. Color applications 
(including grayscale) built with pre-3.2 libraries and header files and moved onto 
a Sun-3/ 1 10 will behave as if they were running on a monochrome monitor. To 
access the pixrect support for the 8-bit deep color buffer, you must recompile 
using the 3.2 libraries and header files. 

Black-and-white applications that are built with pre-3.2 libraries and header files 
will run on a Sun-3/110; you should be able to move pre-3.2 binaries that run in 
black and white onto a 3.2 kernel and run them directly, but you will suffer from 
minor glitches that are artifacts of the multiple plane group architecture of the 
Sun-3/ 1 10 — for example, menus and prompts that intersect color windows will 
be occluded by the color windows. If you do recompile, you will not suffer from 
glitches, but your applications may run somewhat slower due to using the color 
buffer rather than the overlay monochrome plane. You can improve performance 
by making the source code change discussed in the following. 

For all applications, when recompiling with 3.2, the pixwins associated with 
canvas_j?ixwin (canvas) , gf x->gfx_pixwin, and 
pw_open (windowf d) — canvases, graphics subwindows, or pixwins (and 
pixrects) you create — will access the color buffer. The pixwins associated with 
other SunView elements, such as frames, text subwindows, scrollbars, tty 
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subwindows, etc., will attempt to use the overlay monochrome plane. With no 
source code changes, your pixwin and SunView applications will run function- 
ally, be visually correct, and will have no more glitches. If an application uses 
canvases, graphics subwindows, or pixwins/pixrects directly but does not use 
color, the application may run somewhat slowly due to using the color buffer. 

To cause the pixwin to run in the overlay monochrome plane instead of the color 
buffer, make the following source code changes: 

□ For canvases, use the CANVAS_FAST_MONO attribute to either 

window_c reate (frame, CANVAS, CANVAS_FAST_MONO, TRUE, ..., 0) 
or 

window_set (canvas, CANVAS_FAST_MONO, TRUE, 0) 

□ For graphics subwindow applications, call 
pw_use_f ast_monochrome (gfx->gfx_j?ixwin) 

□ For raw pixwin applications, either call 
pw_use_f ast_monochrome (pw) 

or get the original pixwin with the call 
pw - pw_open__monochrome (windowfd) 

These methods are ways of hinting to the pixwin libraiy to put the window 
associated with the pixwin in the fast overlay monochrome plane, if one is 
available. If no such plane is available, or color is explicitly specified else- 
where, these actions do nothing. 

To summarize, the following table outlines how pixwin and SunView applica- 
tions, without any source code changes, will operate when moved onto the 
cgfour: 



Table 4-2 Pixwin and SunView Applications on a cgfour 





Applications Linked with 
Pie-3. 2 Library 


Applications Linked with 
3.2 Library 


Black and 
White 


Will use overlay plane with some 
glitches; recompile to get rid of 
glitches and make source code 
changes(s) to use overlay plane 


Everything except canvases, graphics subwindows, 
and raw pixwins will use overlay plane; make 
source code change(s) to run everything in overlay 
plane 


Color or 
Grayscale 


Will behave as if on a monochrome 
workstation; recompile to use color 
planes 


Will use color planes 
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If you have applications that run on a monochrome frame buffer and are built 
with pre-3.2 libraries and header files, and you do not recompile, your applica- 
tions will run on a 3.2 kernel with a few visible glitches that are artifacts of the 
multiple plane group architecture of the Sun-3/ 1 10. In particular, menus and 
prompts that intersect color windows will not be visible through the color win- 
dows. You can fix this problem by recompiling. 

The previous table describing pixwin and SunView applications on a cgfour sum- 
marizes how SunView applications will behave when moved onto a cgfour. As 
the table notes, one part of your application can use the color planes, while 
another can use the overlay monochrome plane — for example, without recom- 
piling a black-and-white application, your frame will run in the overlay mono- 
chrome plane, while a graphics subwindow inside it will run in the color planes. 
Of course, you can set your frame to be color and the subwindow inside it to be 
black and white by using the Suntools command line arguments. 

If a cursor or crosshair originating in one plane group overlaps a region of the 
screen that belongs to another plane group, the cursor or crosshair will appear 
truncated. 

Sun provides a new facility for creating two full desktops on the same monitor 
(each desktop in a separate plane group). Sun also provides an additional facil- 
ity, called switcher, for moving between the different desktops, and for set- 
ting the enable plane to 0’s or l’s if it appears to be having problems. For more 
information, refer to the SunView Enhancements section of this document. 

Overview users are advised that, because of the existence of plane groups, 
pre-3.2 applications cannot successfully run under overview if overview 
itself is running in the color buffer. For more information, refer to the SunView 
Enhancements section of this document. 

The -b or -f options for suntools are ignored, unless the applications are 
running in an 8bit_color_only desktop. For more information, refer to the 
SunView Enhancements section of this document. 

4.2. Graphics Release 3.2 contains enhancements for the pixrect, GP microcode, SunCGI and 

SunCore software. 

Pixrects The following enhancements are provided by pixrects: 

1) a plane group interface, described in the errata/addenda chapter of this docu- 
ment. (The plane group interface is important to Sun-3/ 1 10 pixrect users 
since it supports the cgfour multiple plane architecture of the Sun-3/ 1 10. 
Sun-3/ 1 10 users should refer to the previous section entitled Sun-3! 110 
Features in this chapter of the release notes.) 

2) two new pixrect/pixwin routines for drawing textured or solid lines and 
polylines with width. These routines are described in the errata/addenda 
chapter of this document; the pixwin routine is also explained in the new 
SunView Programmer’s Guide. 

3) a new pixrect/pixwin routine for drawing multiple points. This routine is 
described in the errata/addendum chapter of this document; the pixwin 
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GP1 Microcode Extensions 



SunCGI 



routine is also explained in the new SuriView Programmer’s Guide. 

1) Graphics programs which are linked with 3.2 libraries and run on a worksta- 
tion with a Graphics Processor ( GP ) will now check whether up-to-date 
microcode is installed on the GP. If up-to-date microcode is not installed, 
programs which use new 3.2 microcode functionality will run, but at a 
slower rate because the new 3.2 microcode features will be emulated in 
software. 

2) Software routines for handling textured vectors, polylines, fat lines, replrop, 
and textured polygons have been replaced by microcode routines, resulting 
in significant performance improvements in these areas. Both Pixrects and 
SunCGI have been changed to take advantage of this. Linking your applica- 
tion to the new SunCGI and/or Pixrect libraries is required to take advantage 
of these improvements. 

1) The way Open View Surface function open_vws uses the Cvwsur f data 
structure has changed. 

The Cvwsur f view surface structure allows an application to request a great 
variety of different “options” or “configurations” for view surface use. 
open_vws uses Cvwsur f to either overlay an existing window, or to create a 
new process (view_surf ace tool) with a graphics subwindow in it. 

Table 2-2 on page 15 of the SunCGI Reference Manual should be modified to 
include the following: 



Table 4-3 Available SunCGI View Surfaces 



Name 


Description 


PIXWINDD 


SunView on either a color 
or monochrome display. 


BWPIXWINDD 


SunView on a mono- 
chrome display. 


CG4DD 


Full screen on a Sun-3/ 1 10 
color display. 



Only some of these configurations are supported. That is, depending on certain 
fields, others will be ignored. The most important rule is that the view surface 
structure should not contain uninitialized variables; fields must contain user data 
or be zeroed out, as by NORMAL VWSURF. If the dd field of the structure is the 
device driver code for a “raw” device (e.g. a Sun-3/1 10 CG4DD device), 
SunCGI attempts to open a device of that variety as follows: 

a) If screenname is non-NULL, exists and matches the dd field, then 
open and use that device. 

b) If /dev/ fb exists and matches the dd field, then open and use 
/dev/ fb. 

c) Check ‘ ‘obvious” device names, (e.g., for GP1DD, try 
/dev/gpone [ 0-9 ] [ a-d] ) The first to match the dd field is opened 
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and used. 

This allows a SunCGI application to create a device-specific program. 

The dd field of the Cvwsurf structure may be assigned (e.g., by 
NORMALVWSURF) the constant CG4DD, indicating the device driver for the 
‘ ‘raw’ ’ Sun- 3/1 10 device. (Behavior is as if it were a CG2). 

The dd field can also contain PIXWINDD, BWPIXWINDD or CGPIXWINDD. The 
meaning of PIXWINDD is changed and BWPIXWINDD is added. BWPIXWINDD 
now specifies that SunCGI should find a window on a monochrome screen; 
CGPIXWINDD, on a color screen. PIXWINDD now means “find any window”. 
(PIXWINDD formerly had the meaning BWPIXWINDD has now, but will gen- 
erally work where it used to.) SunCGI uses the following algorithm in 
open_vws when the dd field is PIXWINDD, BWPIXWINDD or CGPIXWINDD: 

a) if NEWVWSURF bit of flags is 0, windowname is non-NULL, then 
overlay the window with that name; 

b) If NEWVWSURF bit of flags is 0, WINDOWGFX environment vari- 
able exists and that window is not yet used (by this SunCGI process), 
then overlay WINDOW GFX; 

c) If screenname is non-NULL, create view_surf ace_tool on the 
screen with that name; 

d) If windowname is non-NULL, create view_surf ace_tool on the 
same screen as windowname; 

e) If WINDOWGFX is non-NULL, create view_surf ace_tool on the 
same screen as WINDOW GFX. 

In all cases, the screen found by the above algorithm must also match die dd 
field color specification. This restriction is always met if the dd field is 
PIXWINDD, but by specifying BWPIXWINDD or CGPIXWINDD, a SunCGI 
application can refuse to run in certain environments. 

2) SunCGI endstyle meanings have changed. 

line_endstyle determines how the texture is imposed on a textured (non- 
SOLID) line. The enumerated type Cendstyle contains values that 
correspond to valid line endstyles. 

typedef enum { 

NATURAL, 

POINT, 

BEST_FIT 
} Cendstyle; 

The behavior of SunCGI for each of these types has been modified to make the 
results more aesthetically pleasing, and to make the texture alignment for dif- 
ferent line segment lengths more predictable. The following paragraphs contrast 
the old and new behavior of SunCGI endstyles. Polylines of greater than 2 
points behave as if they were “bent” lines: the line texture restarts where it left 
off around the intermediate points. The line texture alternates between ON 
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SunCore 



4.3. Kernel Changes 

cgfour frame buffer 



sections (dashes or dots) and OFF sections (holes). 

NATURAL 

NATURAL texture fitting starts the texture at the beginning of the line, and 
continues drawing or not drawing pixels according to the texture, until it 
reaches the next point If the end point falls within an ON texture section, it 
will be drawn; otherwise it will not be drawn. This can cause line segments 
to appear shorter than they really are. Prior to Release 3.2, SunCGI started 
the texture with the first ON element shortened to half its length, and drew 
only those ON elements which would fit in their entirety within the line 
length. This left a large gap at the end of a line when the line end point fell 
within an ON texture section. 

POINT 

POINT texture fitting draws the same pixels drawn by NATURAL endstyle, 
and in addition will always draw the pixel at the far end of the line. When 
the line ends in an ON texture section, the results are identical with 
NATURAL. POINT produces a line that does not appear shorter than it really 
is. Previously, POINT also drew a NATURAL texture plus the last pixel, but 
since NATURAL endstyle was different, this produced different results than 
3.2 SunCGI’s POINTendstyle. 

BESTFIT 

BESTFIT texture fitting will attempt to center the texture between the two 
end points of a polyline with two points, thus making the texture sections at 
each end point the same length within one pixel. Due to the centering algo- 
rithm, this end point might fall in either an ON or OFF texture section. 
Therefore, the first and last pixels are always drawn, so the line reaches its 
end points and shows its true length. For polylines of more than two points 
(more than one line segment), the texture is not presently balanced over the 
entire polyline. Instead, the behavior is as with POINT endstyle. Previously, 
BEST FIT attempted to place an ON texture section on the end point, but did 
not look consistent for all segment lengths. 

1) The SunCore library now uses the Notifier. Any programs using the Sun- 
Core library should use the Notifier instead of explicit signal calls. 
These changes were made for integration with SunView. 

2) SunCore will work on die Sun-3/ 1 10 view surface. The name of the view 
surface driver is cg4dd. 

3) An improved method for opening a view surface on an existing window 
has been added to SunCore. 



The 3.2 kernel includes support for the "cgfour" frame buffer on the Sun-3/ 1 10. 
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XY450/45 1 disk driver rewrite 



SCSI disk driver * 



Support for Hayes 2400 baud 
modem 

Diag revisions and 
enhancements 



New kernel debugger 



Tektool enhancements 



4.4. C Shell 

Filename Completion Added 
to the C-Shell 



Support for overlapped seeks has been added, improving performance for sys- 
tems with more than one disk per controller. Better support was also added for 
disk drives going offline and coming online while the system is running. The 
maximum supported configurations have been increased. Previously, there was a 
maximum of 2 xy controllers per system with a maximum of 2 disks per con- 
troller. In the 3.2 release, the maximum number of xy controllers and the max- 
imum number of disks per controller are both user-configurable. The error mes- 
sages for the xy450 driver have also been improved. They now report the 
partition-relative and absolute block numbers of the sector in error. Previously, 
the partition-relative block number of the first sector in an erroneous transfer was 
reported, rather than the actual sector in error. 

NOTE: There is a problem with overlapped seeks not working properly on older 
versions of the 450. Config can be used to disable overlapped seeks in this case 
( See the xy man page for details). 



The maximum supported configurations have been increased. Previously, there 
was a maximum of one SCSI Host Adapter and 2 SCSI disks. In 3.2, both of 
these numbers are configurable. The driver now supports the Emulex MD21 
ESDI controller and the associated 141Mb disks. Use of the new controller is 
transparent to the user. 



Changes to uucp and tip now support the Hayes 2400 baud modem. 



Support for the Emulex MD21 SCSI Disk Controller and two 141Mb drives 
(Micropolis 1355 and Toshiba MK156F) has been added. Support for the CDC 
9720 SMD disk drive has also been added. The format utility has been improved 
to automatically read the manufacturer’s defect list on all incoming SMD and 
ESDI drives. Support was also added to manipulate this list manually. 



A standalone adb-style debugger now supports debugging the kernel, or debug- 
ging user-written device drivers. Basic capabilities include setting breakpoints, 
monitoring flow and data structures during execution. 

The Tektronix 4014 terminal emulator tool has been enhanced to include support 
of some of the new SunView capabilities (e.g., scrollbars) within the tektool win- 
dow. 



A filename completion option has been added to the C-shell. If the variable flee 
is set, then typing I CTRL-D I at any point on a command line causes the shell to 
print a list of all filenames that start with the partial input word immediately 
preceding the ( CTRL-D) . Typing ( ESC 1 causes the shell to complete as much of 
the preceding word as is unambiguous. 
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This results in reduced typing, and makes it unnecessary to type cd ... and Is 
repeatedly when locating and using programs and files. See the csh (1) man 
page for more information on flee. 



4.5. System V Users may select the System V Compatibility environment by including 

Compatibility Package /usr / 5bin in the PATH environment variable (before /bin and 

/usr /bin). The default Sun environment only includes those System V 
features that are a compatible superset of 4.xBSD (System V IPC, for example). 
See System V Enhancements Overview (800-1541) for a complete discription of 
the System V Compatibility environment. 

□ Some 4.2BSD functionality has been replaced with the System V implemen- 
tation of the same functionality in cases where both were 100% compatible 
but the System V version is faster. 

4.6. Networking 

File and Record Locking System V compatible file and record locking (f cnt 1 calls) supports both local 

and remote files. A new signal has been added to allow recovery in the event 
that a remote server crashes and locks are lost. Ordinarily, locks will be 
reclaimed when the remote server recovers and SIGLOST will not be issued. 

The signal (SIGLOST) notifies the process in the event of a lost lock. The 
default action is to kill the process, and therefore existing System V programs 
need not be changed to run on the SunOS, unless they choose to recognize this 
failure notification. 

See Unix Interface Reference Manual (800-1303-03) for the following man 
pages: fcntl(2), and lockf{ 3). See the Commands Reference Manual for the Sun 
Workstation (800-1295-03) for lockd( 8c) and statd(8c). 

RPC protocol compiler The new compiler, rpcgen, introduces a language for creating RPC servers 

and XDR routines without having to write any C routines. The compiler 
translates a user-built description of the desired network and services into the 
necessary C routines. 



Remote Execution Service REX is a RPC-based remote execution service that preserves the working direc- 

(REX) toiy and environment variables of the invoking process. Network administration 

must configure the /etc/ server s file to determine if a machine will allow 
this service. A user on a particular workstation does not need to worry about a 
remote system "stealing” CPU time on that workstation without permission. Per- 
formance for remote execution for REX is usually better than using rsh, since 
REX can eliminate the shell invocation that rsh requires. Transparency is also 
better with REX than rsh, since rsh always executes in the home directoiy, while 
REX may use NFS to execute in the directory of invocation. 

See the Commands Reference Manual for the following new REX man pages: 
on( 1), rexd{ 8C), and r<?x(3R). 
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Name server 
UNIFY 



4.7. Languages 

Floating Point Accelerator 
Support 

Inline Expansion Files 

4.8. SunView 
Enhancements 

Backwards compatibility 



The Yellow Pages server uses an inter-domain name resolution protocol for 
names that are not in the default domain. To enable this feature, edit the 
/etc/r c . local file on the Yellow Pages server to add the -i option to the 
ypserv program. The inter-domain name service is provided by the 
/usr /etc/in . named program, as described in the named(& ) man page, and 
the resolver is described in the resolver(3 ) and resolver {5) man pages. There is 
also a ''trivial" name server available. It is described in the tnamed( 8C) man 
page. 

Users upgrading to 3.2 who have installed the UNIFY product should make the 
following changes to their UNIFY installation after 3.2 has been installed. 

In the file /etc/ servers, change the entry for /usr/db/bin/dbrexd to 
be /usr/etc/rpc . rexd, as it is in the /etc/ servers file shipped with 
3.2. 

Replace the files /usr/db/bin/dbrexd and /usr/db/bin/dbon with 
symbolic links with the commands: 

In -s /usr/bin/on /usr/db/bin/dbon 

In -s /usr/etc/rpc .rexd /usr/db/bin/dbrexd 

These changes will cause UNIFY to use the standard REX facilities instead of 
the earlier versions which were embedded in the UNIFY product 



Programs compiled with the -f switch option on Release 3.0 require relinking 
if an FPA is installed. To maximize FPA performance, recompile with the 
-f fpa option. 



In-line code templates have been added to /usr/lib. This allows in-line 
replacement of major routines that previously required calls to library routines. 



Substantial performance improvements and some enhancements have been made 
to SunView. It is not feasible to list all changes, so only those with the greatest 
likely impact on customers have been included. 

The improved display locking and internal window tree enumerator described 
below are supported by changes to window support code in the kernel in 3.2. 
Hence although tools compiled under 3.2 will run on a system running 3.0, they 
will not have the resulting performance improvement. Tools compiled under 3.0 
and 2.x will run under 3.2. 
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SunView Performance 
Improvements 

Graphics performance The display locking overhead of the pixwin library (pw_lock ( ) / 

improvements pw_unlock ( ) ) has been reduced. This results in a general graphics speed up. 

NOTE This is implemented using a shared memory technique (specific to the locking 
code, not a general mechanism ) that was not available in release 3.0. 

Raw text display speed has been improved on memory mapped devices (most 
displays). 

Text subwindows (found in textedit (1), cmdtool (1), mailtool (1), 
etc.) can be made retained as an option in default sedit (1) . This results 
in fast repaint of the window when opened or exposed, at the expense of a slight 
increase in memory usage. The same option for tty subwindows 
(shelltool (1) has a tty subwindow) has existed since 3.0. You should try 
making these window types retained and see if you like the change in interactive 
response on your machine. 

Text subwindow editing speed and display speed have been substantially 
improved, by 40 - 60 % depending on the density of text. 

Caret blinking takes fewer CPU cycles. 

Mouse input performance It is now possible to control the ‘ ‘gain’ ’ of your mouse so that you can cover 

improvements greater distances on the screen with smaller hand motions. This feature is sett- 

able in the Input section of def ault sedit . 

Some settings put in the kernel to support early hardware (the parallel mouse on 
the Sun 100U and 150U) are not optimal for later machines. They can now be 
changed in def ault sedit . The default is for the performance restrictions to 
be in place, so if you have later hardware you should set /Input! Jitter Filter and 
/ Input/ SpeedEnforced to off. 

You use a new utility, input_f r om_def ault s (1), to set these mouse 
motion controls from your personal defaults. This also sets your preferred Sun- 
View function key placement which used to be set by setkey s (1). One way 
to run this automatically is to add the following lines to your . login file: 

if ( 'tty '==/dev/console) then 

echo 'Setting input defaults' 
input_f r ora_def ault s 
endif 

NOTE Inadvertently running input_f rom_de fault s ,for example when you 

r login to someone else’ s machine, will change mouse and keyboard behavior 
even if someone else is using suntools; this is why the example above checks 
to see if you are running on the console. 



Text subwindow performance 
improvements 
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General performance 
improvements 



Merged programs 



By default, tools do not read the system defaults database in 
/usr/lib/def ault s when starting up; they only read the user’s private 
preferences in ~ / . defaults. This reduces tool startup time substantially. 
You should only need to change this if you modify the system defaults database; 
if so you should set Private only in the Defaults category of def ault s edit 
to False. 

Panel initialization and scrolling in panels are faster. 

A quick window enumerator (it returns the position of all windows on the screen) 
has reduced the overhead of tool startup and icon placement upon closing a win- 
dow. 

NOTE The quick window enumerator requires a kernel change, so the performance 
improvement is not available to 3.2 tools running under release 3.0. 

The performance of the folder menu in mailtool has been improved. It 
comes up rapidly if there have been no changes to the folders directory. 

Each executable SunView program includes as much as 400 - 500 KBytes of 
library code from the s untool, sunwindow and pixrect libraries, so individual pro- 
grams take up a lot of disk space. In 3.0 several groups of programs were made 
symbolic links to ♦merge programs. Each determines from the name it is called 
with what “program” it should run, and calls that program, which is really a 
subroutine. This allows several commands to share a single copy of the Sun- 
View libraries on disk and in memory. 

In 3.2, this concept has been extended so that all SunView applications belong to 
one of two sets of tools: 

in /usr/bin/suntools: 

select ion_svc 

switcher 

cmdtool 

shelltool 

ttytool 

textedit 

gfxtool 

vie w_sur face 

coretool 

clock 

clocktool 

suntools 

mailtool 

perfmeter 

overview 

perfmon 

align_equals 

capitalize 

clear_f unctions 

get_selection 

insert_brackets 

shift lines 
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in /usr/bin/othertools: 

fontedit 

iconedit 

tektool 

traffic 

defaultsedit 

mailrc__to_defaults 

default s_to_mailrc 

stty_f rom_defaults 

default s_f r om_input 

input_f r om_de faults 

canvas_demo 

cursor_demo 

bouncedemo 

f ramedemo 

jumpdemo 

spheresdemo 

lockscreen 

locks creen_def ault 

adjacent screens 

swin 

setkeys 

toolplaces 

scrolldefaults 

defaults_to_indentpro 

indentpro_to_defaults 

The benefit of merging all the programs together is twofold. On disk, the two 
merged programs require greatly reduced storage compared with 46 separate pro- 
grams. We have saved about 4 MBytes over 3.0 using this approach. When run- 
ning, multiple “programs” from the same merge share resources of real memory 
and swap space by sharing the same text (code) segment. 

The cost is that each process has a larger data segment that includes many vari- 
ables used by other programs and is not shared. This takes up more swap space 
and can lead to greater paging due to virtual memory fragmentation. Also, if you 
run applications from different merges at once then two large programs contend 
for physical memory, leading to poor performance. 

Sun has found the division of SunView applications into these two sets to be a 
good compromise. The sunt oo Is set includes what we think are the pro- 
grams that are commonly used at the same time, erring toward including more 
programs than less. All the less commonly used programs and programs that are 
not used simultaneously with other programs, such as lockscreen, are in 
othertools. 

We encourage users with better knowledge of their usage patterns to create their 
own merged set of programs that includes the programs they run interactively 
and simultaneously (Sun’s and their own) and excludes the rest. The key is to 
only run programs from one set Specifying your own merge set is like 
configuring the kernel to remove unused device drivers. 
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How to make your own 
toolmerge 



toolmerge is a new feature for 3.2 and subsequent releases. You need both 
SunView optional software programs in order to use it. The following is a brief 
description on how to use it: 

Do the following: 

□ load the SunView Programmers’ optional software. 

□ cd to /usr/src/ sun/ sunt ool and look at the following 3 files: 

toolmerge. c is a program which invokes one of a collection of applications; 
this is done by looking up the name by which it is invoked in the array 
cmdroutinemap, and then calling the corresponding programmain pro- 
cedure. 



basetools . h and othertools . h are include-files which initialize 
cmd_routine_map in toolmerge. c, and also are used to generate symbolic 
links to the merge for each application. 



Because of this second use, the format of the files is critical: each line should 
contain the name by which the program will be invoked (enclosed in double 
quotes), followed by comma, space, the name of the program main pro- 
cedure to invoke (no quotes), another comma, and newline. Example: 
<start-of-line> foot ool , f oo_main , <new-line> 

3) edit the two .h files until they describe the distribution you want: move 
lines from one file to the other to change the category of a particular applica- 
tion; (Be careful to get all references to a single main procedure!) remove 
all references to applications you want to eliminate; add lines to the 
appropriate include file to recognize and invoke applications you want to add 
to the toolmerge. 

4) make basetools and othertools 

When toolmerge . c is compiled, the cmd_r out ine_map is ini- 
tialized 

from a file named by a constant passed in from the makefile. The 
Make variables used for this are BASE_FILES and OTHER_FILES; 
and their default values are basetools . h and othertools . h 
respectively. 

These definition may be overridden explicitly on the make line, thus: 
make basetools BASE__FILES=mytee./i 

If new programs are to be added to either merge, their .o files 
should be named in the Make variable MOREOBJS, thus: 

make basetools MOREOBJS="a.o b.o c.o" 
BASE_Fl'LZS=mybase.h 
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5) make install_bins 

This will generate links to the appropriate merge file for each program 
name in the two .h files. Example: if basetools . h includes the line 
footool, foo_main, 

then the following symbolic link will be constructed: 

In -s /usr/bin/suntools DIR/footool 

where DIR is /usr/bin unless the substring "demo" occurs in the 
name of the program (e.g. "foodemo"); in that case, the link is 
placed in /usr/demo. 



Sun-3/110 Support in The changes made to the pixrect and pixwin layers to provide Sun-3/1 10 support 

SunView are documented in the Sun-31 110 section above. The following subsections cov- 

ers enhancements to SunView, and some suggested code changes to allow appli- 
cations to take advantage of Sun-3/ 1 10 features. It is only relevant to Sun-3/ 1 10 
users and programmers wishing to write Sun-3/ 1 10-compatible applications. 

Smaller pixels => larger font If you are using a Sun-3/ 1 10 with the 15 inch color monitor, you may want to 

increase the default font size that tools use to compensate for the smaller pixels. 
You can set /SunViewlFont in defaults edit to a larger font to make a glo- 
bal change, or you can specify the -Wt fontname command line option to set the 
font in individual tools. 

Running two desktops at once The overlay plane and the color buffer are two separate plane groups on Sun- 

3/110. Changes to sunt oo Is in 3.2 allow you to run sunt oo Is separately 
on each plane group, so that two desktops can be maintained at once. The enable 
plane determine which desktop is visible. Here’s how you do it: 

a) Create a desktop that resides in the color buffer only. >From the console 
type: 

suntools -8bit_color_only -toggle_enable 
This creates a desktop on the color buffer that will not use the overlay plane. 

b) Create a desktop that resides in the overlay plane only. >From a shelltool, 
cmdtool or the root menu execute: 

suntools -d /dev/bwtwoO -toggle_enable -n 

This creates a second desktop running in the overlay plane; to the kernel the 
overlay plane looks identical to the Sun-2 B&W framebuffer. The -n flag 
bypasses reading in the ~/ . suntools or / usr / lib/ . suntools 
startup files, thereby avoiding duplicate tools and consoles in the two desk- 
tops; you can use the -s other jstartup Jde flag instead to start up a dif- 
ferent set of tools on the second desktop. 

c) Run ad jacent screens (1) to set things up so that you can slide the cur- 
sor from one desktop to another. >From a shelltool, cmdtool or the 
root menu execute something like: 



dibh 
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adjacentscreens -c /dev/fb -1 /dev/bwtwoO 

This tells the kernel that the overlay plane is a second “screen” to the left of 
the color buffer. When you move the cursor off the edge of one screen, it 
reappears on the other: the screen flips from one plane group to the other and 
the other desktop appears. 

The effect is to give you rapid access to two different desktops, and thus more 
screen real estate, without the expense of hiding, exposing, closing and opening 
tools. Typically, you would mn your color applications in the color buffer and 
ordinary SunView tools in the black and white overlay plane. 

NOTE If you are going to use this facility: 

□ Do not run old pre-3.2 applications run on the 8bit_color_only desk- 
top; they will not appear because they will be writing to the overlay plane. 

□ Be careful to not have more than one shelltool or cmdtool acting as the con- 
sole at once. Kill one console before starting another, or you will see weird 
effects on the screen. 



switcher There is a new application in /usr/bin called switcher. If you start it 

with the appropriate arguments then it can be used as an alternative to adja- 
centscreens for switching between the two desktops created on your Sun- 
3/1 10 by the above method. Clicking the switcher icon gets you to the other 
desktop using some amusing video wipe animation. 

You can also use switcher just to set the enable plane to 0 or 1 if the enable 
plane gets out of sync so that you are not seeing the correct plane group. See the 
man page swit cher ( 1) for details. 



Plane groups and overview You can’t successfully run pre-3.2 applications under overview if over- 
view itself is running in the color buffer. If overview is not in the overlay 
plane then the enable plane isn’t be properly set up to see the application running 
under overview. This means that you can’t run overview with the -Wf 
or -Wb generic tool command line arguments to set its colors. Also, you can’t 
run overview in an 8bit_color_only desktop. 



Foreground and background in The -b or -f options to suntools are for the most part ignored unless you 

suntools run it in an 8bit_color_only desktop. This is because the overlay plane 

can only display black and white, and suntools attempts to run in the overlay 
plane to speed its operation and the tools run under it. 



Using the overlay plane 
programmatically 



Although the default plane group when you open a pixrect or pixwin is the color 
buffer, frames, panels, tty subwindows and text subwindows will all use the over- 
lay plane if possible because the code for them hints to use the overlay plane. 

Canvases and gfx subwindows in applications compiled under 3.2 will access the 
color buffer, on the assumption that you are likely to want to draw in them in 
color. This is fine, but will slow down your application if it is only drawing in 
black and white. When you recompile you can make minor code changes that 
cause the sub window to display in the overlay plane: 
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New routines for caching screen 
pixels 

Extensions Visible to the User 
Scrollbar extensions 



Text extensions 



□ For canvases, use the CANVAS_FAST_MONO attribute in either 

window_create (frame, CANVAS, CANVAS_FAST_MONO, TRUE, .... 0) 
or 

window_set ( canvas , CANVAS_FAST_MONO , TRUE , 0 ) 

□ For applications that use the old SunWindows gfx subwindow type, use the 
call pw_use_fast_monochrome (gf x->gfx_jpixwin) . 

These are just hints to the window system to use the overlay plane; the user can 
overrule them and use color by specifying the generic window command line 
arguments -Wf , -Wb and -Wg. 

If you have written your own menu or prompt package that does its own caching 
of screen bits, you should instead use the new pixel caching utilities available in 
3.2, pw_save_pixels ( ) and pw_restore_pixels. Doingyourown 
pixel caching can result in screen image damage on a Sun-3/ 1 10 in the plane 
group that you didn’t cache. Programs that use the SunView menu and prompt 
facilities are not affected by this problem. 



A continuous repeat facility has been added to the scrollbar user interface; after a 
delay determined by I Scrollbar! Repeat time in def aultsedit, the scrolling 
action is repeated as long as you hold down the mouse button. 

Thumbing (middle button) in the top or bottom N pixels of the scrollbar moves 
the scroll to the very beginning or end of the object. The value of N is 
/Scrollbar! End _point_area in def aultsedit. 

The thumbing bar and scroll boxes parts of a scrollbar have different cursors to 
indicate that the mouse buttons function differently in them. 

A checkpoint facility has been added to textedit and cmdtool; it serves as 
an optional crash recovery mechanism. If enabled it periodically writes out a 
backup copy of the file you are editing to filename%%. The creation of this 
backup file is a separate process from the filename % file that textedit creates 
when you save a file. 

The entire file is written to filename%% after every N edits to the file, where N is 
determined by the user; each character typed, each Get and each Delete operation 
counts as an edit. Thus to recover from a crash you need only copy filename % %, 
losing at most N edits. 

Checkpointing is enabled by setting Checkpoint frequency ( N ) to a non-zero 
value in the Text and Tty categories of def aultsedit. It can also be enabled 
by the command line option -Ec N of textedit and -P N of cmdtool. 
By default N is 0 so checkpointing is disabled. 

The tool is “dead” while it checkpoints the file, so values of N below 200 or so 
are probably a bad idea. 
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New defaults 



Other extensions 



Extensions Visible to the 
Programmer 

Revised manuals 



There is another new defaults option for all text subwindows, 

ITextl Store changes Jile. By default it is True , which means that ’Store’ in the 
text subwindow works as it always has: after storing to the filename selected, it 
loads that file. If set to False, then ’Store’ does not load the file that was stored 
to, keeping loaded the file you started editing. 

def aultsedit can be used to set additional default parameters; many have 
been mentioned already. 

There is a new category, Input, which lets you control the responsiveness of your 
mouse (see General Performance Improvements above) and keyboard function 
key assignments (previously set by the set keys command). The Left Handed 
default both moves the SunView function keys to the right hand pad and swaps 
the left and right mouse buttons. 

The Input category, together with input_f rom_def ault s (described 
above), which sets preferences in the kernel, make set keys somewhat 
obsolete unless you want to swap the keyboard around without affecting the 
mouse. 

iconedit (1) has a browsing facility. A pop-up frame displays icons, cursors 
and glyphs in the current directory, which you can set. 

You can specify whether frame labels are to be emboldened in 
default sedit. 

You can specify either a pattern or an image to serve as the background image in 
suntools (1) instead of the “root gray” pattern in def aultsedit or by the 
-pattern or -background options to suntools. 



The SunView Programmer’ s Guide and SunView System Programmer’ s Guide 
have been revised and reprinted for release 3.2. The former in particular has 
been significandy improved: 

□ The explanation of the SunView model and programmatic interface is better. 

□ All functions and attributes are listed in a new summary chapter. 

o There are many new examples throughout, and several long ones in a new 
appendix of examples. 

□ There is a new appendix on converting SunWindows-based code to Sun- 
View. 

□ There is a new appendix on SunView user interface guidelines. 

□ There are many more screendumps throughout the text. 
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Extensions to attributes 



New pixwin calls: 
Line drawing 



Multiple points 



Fullscreen access pixel caching 
and drawing routines 



There is a new frame attribute, FRAME_CMDL INE_HE LP_P ROC to aid in writ- 
ing custom “Usage: ...” messages in programs; this in turn can call the pro- 
cedure frame_cmdline_help () which prints out the generic switches. 
This provides the same functionality as the old tool_usage ( ) procedure. 

You can specify that the frame label is to be emboldened with the attribute 
FRAME_EMBO LD EN_L ABE L (or via default sedit; see above). 

There is a new tty attribute, TT Y_BOLDST YLE_NAME , corresponding to the 
/Tty/Bold_style preference in default sedit. The possible styles for bold 
characters are listed in <suntool/ttysw.h>. 

It is possible to create reusable attribute lists with the new 
attr_create_list () routine. This generalizes the 
panel_make_list ( ) call from 3.0. 

Three new event descriptors, WIN_LEFT_KEYS, WIN_TOP_KEYS and 
WIN_RIGHT_KEYS, allow you to enable these groups of function keys as a 
whole. 

There are several new text subwindow attributes: 

TEXT SW_AGAIN_RECORD ING 

TEXTSW_CHECKPOINT_FREQUENCY 

TEXTSW_CONTROL_CHARS_USE_FONT 

TEXT S W_ED I T_COUNT 

TEXTSW_IGNORE_LIMIT 

TEXT SW_INSERT_MAKES_VI S IBLE 

TEXTSW MEMORY MAXIMUM 



There are new pixwin calls for drawing plain or textured lines and polylines with 
a “brush” of a specified width: 

pw_line(pw, xO, yO, xl, yl, brush, tex, op) 

pw_polyline (dpw, dx, dy, npts, ptlist, mvlist, brush, tex, o 

These correspond to the pixrect level calls pr_line() and 
pr_polyline ( ) , documented in the errata to the Pixrect Reference Manual. 

There is a new routine to draw many pixels in a single call: 

pw_polypoint (pw, dx, dy, npts, ptlist, op) 

This is similar to the pw_put ( ) routine, except that it fills in npt s pixels in a 
single call. 

There are new routines to save and restore pixels that are compatible with the 
Sun-3/ 1 10 — see New routines for caching screen pixels in the Sun-31 110 Sup- 
port in SunView section above. Typically, you would only need to use these rou- 
tines if you are writing applications that implement their own menus or prompts 
instead of using the Sun supplied library packages. These applications need to 
save the image underneath the menu or prompt before displaying it, and the new 
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Unencoded input 
Other Extensions 



4.9. New Fonts 

4.10. Miscellaneous 
Changes 

touch 



routines ensure that the pixels in the right plane group are cached. They are: 

pw_save_pixels (pw, r) ; 
pw_restore_pixels (pw, pc) ; 

There are routines for drawing during fullscreen access that accommodate the 
multiple plane group frame buffer of the Sun-3/ 1 10: 

f ullscreen_jpw_vector (pw, xO, yO, xl, yl, \ 

op, cms_index) ; 

fullscreen_pw_write (pw, xw, yw, width, height, \ 

op, pr, xr, yr) ; 

f ullscreen_pw_copy (pw, xw, yw, width, height, \ 

op, pw_src, xr, yr) ; 

These routines are documented in the Menus & Prompts chapter of the SunView 
System Programmer’s Guide , (other programming topics in these change notes 
are mosdy in the new SunView Programmer’s Guide). 



A new option for the keyboard ioctl KIOCTRANS, TR UNTRANS EVENT, has been 
added to support unencoded input in the window system for the few applications 
that demand it. See the Workstations chapter in the SunView System 
Programmer’ s Guide. 



Two new typedef s were added (the header file 
<pixrect/pixrect_hs .h> includes them): 

typedef struct pixrect Pixrect in <pixrect/pixrect .h> 
typedef struct pixfont Pixfont in <pixrect/pixfont .h> 

These are consistent with other SunView typedef s — Pixwin, Rect, 
Event, etc. Note that if you have defined these typedef s yourself in your 
code you will have to remove them. 



There are now several new fonts available in 3.2. For a complete listing see 
/usr/lib/f onts/f ixedwidthfonts /README. 



The touch command formerly exited with an exit status of 0. In 3.2, it exits 
with an exit status giving the number of files it was not able to "touch". This 
may break some Makefiles because they may do a "touch" on a file that every- 
body who uses the Makefile can touch (e.g. they do not have "write" permission 
on the file. Change the Makefile so the exit status of the touch command is 
ignored. The - character can be used for this. 
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reading directories 



mount( 8) 
timezone changes 



In all releases before 3.0, programs could open a directory and read the contents 
with read{ 2) system call. In 3.0 and beyond, directories must be read with either 
getdirentries(2) or directory (3) library. 

mount(%) now has additional options for mounting remote file systems. See the 
man page for more details. 



Some new Daylight Savings time types have been added. They are specified as 
numbers. The "timezone" line of the config file is: 

timezone <offset> [ dst <type> ] 

<o££set> is the offset of the current time zone, in hours. It can be positive or 
negative; if negative, it represents a time east of the Greenwich meridian (i.e., a 
negative offset). It can be specified as a floating point number, for fractional 
offsets; e.g., a time zone offset of minus 9 and a half hours from GMT would be 
specified as 



timezone -9.5 

with the appropriate "dst" value. If "dst" is not specified, Daylight Savings Time 
is not in effect. If it is specified, and no <type> is specified, it is assumed to obey 
the standard. 

This stuff is described, although in slightly less detail, in Installing UNIX on the 
Sun Workstation in chapter 7, "Configuring the System Kernel", under "General 
System Description Lines". It lists a set of values for the time zone correction 
algorithm. The ones we added are: 

6 (Canadian - same as the US, but without the changes in 1974 and 1975 and 
without the changes starting in 1987), 7 (Great Britain and Eire - from the 
last Sunday in March to the last Sunday in October), 9 (Turkish - same as 
Continental Europe, except that it turns on at 1:00 Standard time and off at 
1:00 Daylight Savings time), and 10 (Australian "alternate" - see below). 

The US rules have been modified; the corrections for 1974 and 1975 have 
been corrected (1974 - runs from January 6 to the last Sunday in October, 
1985 - Runs from the last Sunday in February to the last Sunday in October), 
and starting in 1987, it runs from the first Sunday in April to the last Sunday 
in October. 

The Australian rules have been corrected also. They currently have it run- 
ning from the last Sunday in October to the first Sunday in March (really - 
they’re in the Southern Hemisphere), except in 1970 when it was not in 
effect at all, 1971 when it did not run in the beginning of the year, and 1972 
when it ran from January 1 to February 27 in the beginning of the year. 

The "Australian alternate" rules shift so that it runs until the third Sunday in 
March in the beginning of the year, starting in 1986, and still ends on the last 
Sunday in October. It is not known which states have this shift. 
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4.11. Sun-3/260 & Sun- 
3/280 Enhancements 

Applications 
General Changes 



The rules for Continental Europe have been corrected; it always runs from 
the last Sunday in March to the last Sunday in September. 

The starting and ending times have also been corrected. In Great Britain, 
Eire, and Western Europe (WET), it starts at 1:00 Standard time and turns 
off at 1:00 Standard time (i.e., 2:00 DST). In Central Europe, it starts at 
2:00 Standard time and turns off at 2:00 Standard time (i.e., 3:00 DST). In 
Eastern Europe, it starts at 3:00 Standard time and turns off at 3:00 Standard 
time (i.e., 4:00 DST). 

If the time zone offset is specified 0, then the *names* of the time zones will 
be GMT and BST (British Summer Time), rather than WET and WET DST 
(Western European Time). Portugal is the only other country with this 
offset. 

In Australia, it starts at 2:00 Standard time and turns off at 2:00 Standard 
time (i.e., 3:00 DST). 

It’s still the same in the US and in Canada. 

One warning: if any of the new times are selected, software built on a 3.1 or 
earlier system will not understand it; it will not have the new rales built in, 
and will think that Daylight Savings Time is not in effect This will prob- 
ably break few programs, but people should be aware that it may happen. 



This release also supports the Sun-3/260 and the Sun-3/280 systems. These are 
MC68020 based machines that are available with one of two monitors: a new 
high-resolution monochrome monitor and a standard 19" color monitor. 

Black and white applications running on the new high-resolution monitor MUST 
be recomplied to scale correctly on the screen. 

Color applications NEED NOT be recompiled, since they run unchanged on the 
standard 19" color monitor. 



If you are using a Sun-3/200 with the high resolution monochrome monitor, you 
may want to increase the default font size that tools use to compensate for its 
smaller pixels. You can set /SunView/Font in de fault s edit to a larger font 
to make a global change, or you can specify the -Vltfontname command line 
option to set the font in individual tools. 

Similarly, you may want to make changes in your ~ / . sunt oo Is file to make 
use of the greater amount of screen real estate available. 

A server and its diskless clients must ran the same release software. All 
server/client clusters must be updated to this release. 

Additional Adobe fonts have been added to the Font library and are standard with 
this release when installed through Setup. Because of the new high resolution 
monitor, there is the possibility that the default font will be smaller when using 
this release. The user may want to rescale the suntools file or pick a larger font. 
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5.1. Compiler 



FORTRAN 
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Bug Fixes since Release 3.0 



For all the compilers, the software command line options have been changed. In 
all previous versions you could concatanate separate options (e.g. -a, -b and -c: 
-abc) In 3.2, you must specify each option separately (-a, -b, or -c). Now we 
have multiple character options which make it impossible to parse die command 
line. This affects old compiler makefiles and shell scripts. 

An incorrectly initialized pointer in the static data area caused program bus errors 
on the RETURN statement in a module with multiple entry points. This has been 
fixed. 

/77 now returns an error status when there is a loader error. 

A data statement after the first executable statement that initialized a variable 
which was never referenced caused the compiler to abort with the message: 
do_bss : initialized non-static. This is fixed. 

A DO loop with a floating point index variable and integer constant loop limits 
caused the compiler to abort with the message:Compiler error : 
conssgn (nonconstant) . This is fixed. 

The compiler no longer computes the wrong constant offset for a reference of the 
form STRING ( 1 ) ( 1 : ) when STRING is a subroutine argument which is 

declared as CHARACTER* (*) . 

The compiler no longer produces the error message "wrong number of sub- 
scripts" for statement function references if a dummy argument of a statement 
function has the same name as an array. 

Character string constants or concatenation of character constants longer than 
242 characters no longer causes the compiler to abort with a core dump. 

The code generated for subscript checking when the -C option is specified previ- 
ously used a different temporary for each subscript check. This caused a pro- 
gram to use an excessive amount of stack space or in some cases exceed the limit 
of 64K bytes of stack space per module. The compiler has been changed to use 
the same temporary variable for all subscript checks. 
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C compiler 



5.2. Graphics 
SunCGI 



printf used to round real numbers between 0.5 and 1.0 to 0. This has now been 
fixed. 

The library routine execat used an incorrect constant for the maximum length 
of a pathname. The code has now been fixed. 

A bug in the optimizer J 1 ib / c 2 occasionally caused register load instructions 
to be deleted from program loops. This has been fixed. Only programs compiled 
with -O are affected. 

Comparisons involving variables of small integral type and constants outside the 
legal range for that type now draw a warning. The code generated for an out-of- 
range comparison will be changed in release 4.0. 

Release 3.2 contains bug fixes for the SunCGI software. 

1) dis joint_poly line used to draw 1 line too few. 

2) When exiting SunCGI with multiple workstations, in particular when 
using View Surface Tools , SunCGI occasionally would kill its process 
group. The message Killed is no longer printed in the controlling win- 
dow (/dev/tty) when a SunCGI program exits. 

3) SunCGI always uses the ‘ ‘global drawing mode’ ’ (Raster Operation), so 
any primitive may be XOR-ed onto the screen. 

4) Width=l rectangle perimeters match a polyline drawn between the comers 
of the rectangle. 

5) open_vws uses the “windowname” field of the Cvwsurf structure, 
overriding the value of the WINDOW GFX environment variable. 

6) Textured (non-SOLID) lines are optimized. The results are slightly more 
pleasing visually, and considerably faster, especially if on a screen using a 
Graphics Processor. This change affects polyline, 

dis joint_poly line, and the perimeters (if perimeter visibility is ON) 
of rectangles and polygons. Section 4.2.3 contrasts the old and new 
behavior of SunCGI endstyles. 

7) Textured polygons (interior style PATTERN or HATCH) are optimized. 

The results are identical visually, and considerably faster for some 
polygons, especially on a screen using a Graphics Processor. 

8) Coordinate handling in cgipw mode has been optimized, so certain cgipw 
output primitives should be faster, at least for non-Graphics Processor 
devices. These are cgipw_polyline, 

cgipw_dis joint_jpolyline and cgipw_polygon. 

9) Previous releases of 1 ibcgi7 7 . a would fail to link several internal rou- 
tines. 

10) As documented for Clip Indicator , the default clipping state is now CLIP. 

Numerous bugs that affect the output of text characters have been fixed. Most 
combinations of text path and alignment did not work correctly in previous 
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versions, producing text that was misaligned, and returning text extent boxes 

from inquire_text_extent that did not match the text. Specific bugs that 

have been fixed are: 

11) The text extent and concatenation point for fixed- width fonts was incorrect. 

12) Text extent box did not include space for descenders unless characters with 
descenders were included in the string. 

13) Text extent box never included parts of characters that rise above the cap 
line. 

14) Vertical alignment did not distinguish between cap line and top line, or 
between base line and bottom line. 

15) When the character base vector and character up vector were not perpen- 
dicular (skewed text) the text extent box did not enclose the text. 

16) The extent parallelogram for text strings always included the space after 
the final character. 

17) The character height was formerly the distance between the base line and 
the top line, instead of that between the base line and cap line. 

1 8) Clipping in CHARACTER precision used only one comer of the character 
box to determine if the character was within the clipping window. CHAR- 
ACTER and STROKE precision both clip correctly. In this release, both 
clip as in STROKE precision. Other optimizations should make both clip- 
ping styles faster. 

19) The text append point for strings that extended past an edge of the window 
could wrap around if their length was as small as two window widths (or 
heights). This should no longer happen in normal cases. 

20) The character extents for different fonts were treated as if they were identi- 
cal, even thought the character definitions had different top lines and bot- 
tom lines. This caused some fonts to exceed the text extent parallelogram 
even for RIGHT path and (NRMAL, NORMAL) alignment (the default 
case). 

21) STRING precision text was always aligned (LEFT, BASE) regardless of 
attributes the user set. STRING precision should now work correctly for all 
alignments, with the following caveats: 

a) Only RIGHT path is supported, as the standard permits. 

b) Cap line and top line are the same, since STRING precision uses the 
raster fonts, where no character is higher than a cap. 

c) Character height, orientation, expansion factor, and spacing are 
ignored, as the standard permits. 
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5.3. Kernel 
driver 

Other 

5.4. Utilities 

sees 

dbx and dbxtool 



The following tty delays were too long: crl, cr2, and nl2. According to the 
tty{ 4) man page, crl should be about .08 seconds; cr2 about .16 seconds; and nl2 
about .10 seconds. In actuality, they were about 2 to 3 seconds. The algorithms 
in tty.c have been fixed. 



An mbuf chain released by sbdrop in the source file 
sys/uipc_socket2 .c can no longer cause a panic : sbf lush2. 

The /dev/MAKEDEV script has been modified so you can position the tape 
using the QIC-24 device. 



SCCS no longer trashes files when a file system runs out of space during an 
admin or a delta command. 



Here is a list of new features in release 3.2 related to dbx and dbxtool: 

1. There is a new command called make, which invokes the make program 
with the name of the program being debugged as an argument. It also gives 
the value of the dbxenv makeargs variable as an argument to the make 
program. 

2. There is a new dbxenv variable called makeargs. The value of this vari- 
able is passed to the make program when the make command is executed. 
The default value is CC=cc -g. 

3. The default setting of f ile and f unc has changed. Now, whenever the 
program being debugged stops, dbx sets the value of f unc by walking the 
active call stack and finding the lowest-level routine that was compiled with 
the -g option. The value of file is then set to the file that contains func. 

4. In dbxtool there is now a menu of dbx commands available in the but- 
tons subwindow. Pressing the menu button (right button) anywhere in this 
subwindow brings up the menu. The commands in the menu have the same 
behavior as the buttons; that is, they have a selection interpretation and use 
the command name, the interpretation, and the current selection to construct 
a command. The default set of menu items is: 
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menu expand display 
menu expand undisplay 
menu expand file 
menu expand func 
menu ignore status 
menu lineno "cont at" 
menu ignore make 
menu ignore kill 
menu expand list 
menu ignore help 

5. There is a new command called menu, which is analogous to the button 
command. Its syntax is as follows: 

menu selection command-name 

It allows a user to add items to the menu. 

6. There is a new command called unmenu. This command is analogous to 
the unbutton command. Its syntax is as follows: 

unmenu command-name 

It allows a user to remove items from the menu. 

7. The default set of buttons has changed for dbxtool; it is now: 

button expand print 
button expand "print *" 
button ignore next 
button ignore step 
button lineno "stop at" 
button ignore cont 
button expand "stop in" 
button lineno clear 
button ignore where 
button ignore up 
button ignore down 
button ignore run 

8. In dbxtool, the meaning of the hollow arrow has changed, and a solid 
arrow has been introduced. The solid arrow is the “here I am’ ’ arrow. It 
points to the next statement to be executed. If the current stopping point was 
not compiled with -g and dbx finds a calling routine that was, a hollow 
arrow will be shown next to the call. In a similar manner, the hollow arrow 
is used to show the call sites for the up and down commands. 

9. The debugging manual for release 3.0 mentions an attach command for 
dbx. No such command exists. The way to attach a process for debugging 
is with the debug command. 

10. When referring to a non-unique name that is neither global nor local to the 
current procedure, you must use an unambiguous qualifier. The old way to 
constitute the qualifier was: 
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Programs 



Mail 



sendmail 



[filename . ] procedure-name . variable 
The new way is: 

[ ' filename ' ] procedure-name ' variable 

A backquote is used instead of a period, and a backquote is also required in 
front of the filename. The period is now used only for referencing a field of 
a structure (or record).! 

The curses input functions were going into RAW mode rather than CBREAK 
mode. This has been fixed; they now go into CBREAK mode as documented. 

NOTE Programs using " curses " which were compiled under pre-3.2 releases will run 

under 3.2 without change, but cannot be relinked under 3.2 without recompiling. 

Executing touch -c on a file that does not exist now returns a non-zero exit 
status. 

The status code returned by f s ck -n now indicates an error if there is one. 

The leave command used to accept input with incorrect syntax, and then set the 
alarm to the wrong time. This has been fixed. 

Using man and more on a Wyse terminal, italics get turned into underlines. If an 
underlined word were at the end of a line, the underline would continue to the 
edge of the screen. This has been fixed. 

When rm was used on an existing file in a directory which was not readable or 
writable, a "nonexistent" file message was returned rather than access 
denied. This has been fixed. 

The spell command was not finding all the mispelled words when it was run 
on a file. The problem was in /usr /lib/ spell. The dictionary has been 
improved so it finds more mispelled words now. 



Secret mail now properly decodes messages. There was a bug in the mp library 
which improperly handled an intersection in the domain and range of many func- 
tions. 



The file sendmail . main . cf did not work in 3.0. It now correctly uses the 
host name map (or the file /etc/hosts if not running the Yellow Pages) 
instead of the file /usr/lib/mailhosts. 

sendmail . cf can now use the same domain name as set by the kernel. This 
should cut down the customization needed for sendmail . cf on each 
machine. The top-level domain default is now ".com" instead of ".uucp". 



t When debugging Pascal programs, list procedure-names separated by backquotes to indicate nesting. 
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routed 



rlogin 



5.5. Shell 

Bourne Shell 



5.6. General Bug Fixes 

LaserWriter 



In some situations sendmail would silently discard messages if aliases 
formed a loop without any host names appearing, sendmail now issues an 
error message in these circumstances. 

Load limits now default to zero which prevents sendmail from hanging when 
a kernel other than / vmunix is booted. 

The -ee mode which /bin/ rmail uses for incoming uucp mail now no 
longer sends extra copies of returned messages. 

Underscore characters are now allowed in user names. 

When a mailer dies from a signal, the error message now gives the symbolic 
name of the signal instead of the numeric value. For example, the "Kill" signal, 
number 9, usually means that swap space has run out. 

sendmail with either the — bv option or the SMTP VRFY command 
no longer causes address verification to send out a 
null message if it is interrupted before the verify 
operation completes . 



The routing daemon /etc/ in . routed previously read the interface informa- 
tion from the /vmunix and /dev/kmem files, which meant that routing 
would not work if a kernel other than /vmunix was booted. Routed was 
changed in 3.2 to use socket ioctl calls instead of looking at the kernel. Rout- 
ing now works no matter what kernel is booted. 

The new rlogin program correctly propagates the terminal or window size to the 
remote system if the local and remote systems are both running 3.2 or newer. 
There was a problem with hanging connections (when exiting certain programs 
such as emacs) that has been fixed in this release. 



The Bourne shell will ignore evironment variables with "funny" names, such as 
"A-B". 

csh now prints messages like "Stopped", "Quit", "Segmentation Fault", and oth- 
ers as it should. 

csh kill command now accepts all of the ASCII signal names (as per 
/bin/kill). 



There is a new filter, rasfilter8tol, which converts an 8 bit rasterfile into a 1-bit 
rasterfile. See the man page rasfilter8tol(l) for complete details. 
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tftpboot 



5.7. SunView Bug Fixes 



Bug Fixes Visible to the User 

Bug fixes in the text subwindow 
package and text edit 



Panel subwindow fixes 



Tool command line argument 
changes 



Note: You may wish to change your 
. suntools file to adjust for these 
changes. 



Diskless Sun-3 workstations use the tf tp protocol to bootstrap. For some 
users, this may be a problem because the default tf tp server allows access to 
any fil that is publicly readable. To increase security, remove the entry for 
tf tp in the /etc/ servers file on diskless clients, and change 
/etc/servers on the file server to be: 



#tftp udp /usr/etc/in.tftpd 
#tftp udp /usr/etc/in. tftpbootd 



By default, the second line is commented out, which allows access to all 
publicly-readable files. To make the change to limit tftp to booting only, just 
move the comment character to the first line as indicated above, and kill and res- 
tart / etc/ inetd (or reboot) for this to take effect. 



Release 3.0 was the first release of die new SunView window interface and 
toolkit. Many bugs in it have been fixed for 3.2. It is not feasible to list all the 
minor or internal bug fixes here, so those with the greatest likely impact on cus- 
tomers have been detailed. 



Scratch text files created in /tmp have read- write permissions for their owner 
only. This plugs a potential security leak. 

You can strike a key to cancel confirmation prompts from textedit. 

Pressing I Again 1 to repeat the invocation of a filter no longer dumps core. 

When you insert a large file into a text window, it no longer scrolls all the way 
through line by line. 

Numerous other bugs in textedit have been fixed. 

Panels with text items replace the caret with a grey diamond when they don’t 
have the keyboard focus; this is consistent with the text subwindow. 

Text now always goes to the item with the caret when you use ( Get) in a panel. 

Using the -Wt fontname command line option to specify the font for a tool now 
works for all tools. 

In 3.0 the window width for cmdtool specified by the -Ww columns command 
line option included the scrollbar in the width calculation. Now the actual text 
display area matches the requested width. 
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Subwindow resizing 
Other bug fixes 

Bug Fixes Visible to the 
Programmer 

Fixes to attributes 



Limitations in 
window_loop ( ) fixed 



The default width of cmdtool, textedit, and mailtool is now 80 charac- 
ters. 

You can specify -1 as the value for position and size attributes on the command 
line and an appropriate value will be used; this is for compatibility with old for- 
mat . s untools files. 

In 2.0 SunWindows, when you resized tools the subwindows would be re-laid out 
within the tool border. In 3.0 SunView, subwindows were not re-laid out when 
windows were shrunk. This is fixed. 

Hidden areas of windows are redrawn in English reading order when the tool is 
exposed. 

In addition to internal bug fixes, mailtool’s folder menu is more square and 
in better order, its menu accelerators are clearer and its icon and name stripe 
more accurately reflect when there is New Mail. 



FRAME_LABEL operates independently of FRAME_S H OW_L ABE L ; also the 
subwindow changes position accordingly upon setting and unsetting 
FRAME_S HOW_L ABEL . 

The WIN_ROW_GAP and WIN_COL_GAP for frames now default to 0, which 
makes it possible, e.g. to get the frame the same size as a 34x80 shelltool. 
They defaulted to 5 before, so this may affect the size of your tools. 

You can now set the WIN_EVENT_PROC of ttysw’s and textsw’s. Before the 
attribute was only used by canvases and panels. 

The default top margin of panels in tools written using the 2.0 SunWindows rou- 
tines is set to 4 pixels in 3.2 when they are recompiled; this is as it was in 2.x. In 
3.0 the top margin changed to 0 pixels when such old-style tools were recom- 
piled. You may have to alter panel layout code to cope with the change. 

TTY_SAVE_PARAMETERS has been de-implemented in 3.2 as the tty subwin- 
dow package no longer does anything in response to it. In 3.0 it was incorrectly 
documented as taking a boolean value. See the TTY Subwindows chapter in the 
SunView Programmer’s Guide for more information. 

In 3.0 there were limitations on what you could do when using 
window_loop ( ) to put up a “confirmer” subframe. If the subwindow in the 
subframe put up a menu, the application was liable to get 

Window data lock broken because pid nnn blocked 

messages. If the subwindow did extensive computation, say in a panel item’s 
notify proc, it might get 

Window data lock broken after time limit exceeded by pid nnn 
The offending process was sent SIGXCPU 
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Other bug fixes 



messages, and be killed. Both problems have been fixed by using 
win_grabio() for the duration of window_loop ( ) instead of holding the 
data lock. 

window_destroy ( ) now closes the file descriptor of the window, plugging a 
file descriptor leak. (A similar bug in the old-style tool_destroy ( ) call has 
also been fixed.) 

The selection library has been fixed so it will not steal the socket of another RPC 
server in the same process; in 3.0 this would occasionally happen leading to ran- 
dom hung processes. 

Input to a tty subwindow using tty sw_input ( ) shows up immediately; in 
3.0 it didn’t show up until you moved the mouse into the subwindow. 
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Pixrect Reference Manual 



The following pages are Errata and Addenda for Sun Release 3.0 version of the 
Pixrect Reference Manual — Sun Part Number: 800-1254. 



6.1. Graphics: Pixrect 
Reference Manual 

Raster Operations and Color Page 14 

Pixrects — Addenda Section 2.6, Ops with a Constant Source Value, should include the following 

information: 

1) As of this release, Sun fully supports 1-bit and 8-bit pixrects; Sun par- 
tially supports pixrects of 16 and 32 bits. Currently, operations can only 
be performed between pixrects of the same depth, unless the source pix- 
rect depth is 1 bit and the destination pixrect depth is 8 bits. This excep- 
tion is discussed below. 

2) The color argument is encoded in the raster operation code with the 

P IX_COLOR macro. P IX_COLOR is used in two cases: (1) if the source 
pixrect is NULL, in which case the destination pixrect is operated on 
using the source value specified with PIX_COLOR; and (2) if the source 
pixrect and destination pixrect have different depths (a source pixrect 
depth of 1 and a destination pixrect depth of 8), in which case the desti- 
nation pixrect is operated upon per (4) below. 

3) For source and destination pixrects of equal depths, all raster operations 
are valid and will act on color indices. For example,: when you OR two 
colors, the operation is performed on the two color indices, not the colors 
themselves. 

4) If a source pixrect has a depth of 1 and a destination pixrect has a depth 
of 8, the source pixrect is treated as though each pixel set to 0 was 
depth-8 (00000000), and each pixel set to 1 was depdf-8 and of the 
color indicated by the P IX_COLOR index. The two indices are operated 
upon as in (3). When P IX_COLOR is omitted or set to 0 in the op argu- 
ment but is needed for a raster operation, then a PIX_COLOR index of 
-1 is used (foreground). 
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5) On monochrome machines, a non-zero PIX COLOR index is treated as 
1, and a zero P IX COLOR index is treated as 0. 



Grayscale Workstations — 
Addenda 



Multi-Pixel Operations — 
Addenda 



Page 22 

Section 2.8, Colormap Access, should include the following information on 

colormaps and grayscale workstations: 

1) For clarification: Sun colormaps are set up as follows: 

□ The colormap size for monochrome monitors is 2. 

□ The colormap size for grayscale monitors is 256. 

□ The colormap size for color monitors is 256. 

2) If you plan to use a colormap with your grayscale workstation, be sure to 
load all three (RGB) colormaps with the same values when programming 
the colormap. It will ensure that your application will behave as you 
want if you use a color workstation. 

3) All current Sun grayscale workstations use the Red gun to drive its 
grayscale monitor. 

Section 2.7 should include the following: (1) two new routines that draw textured 
or solid lines and polylines with width, and (2) a new routine that draws multiple 
points. 



Draw Textured or Solid Lines tdefine pr_line(pr, xO, yO, xl, yl, brush, tex, op) 
with Width struct pixrect *pr; 

int xO, yO, xl, yl; 
struct pr_brush *brush; 
struct pr_texture *tex; 
int op; 

The pr_line macro draws a textured line based on the Bresenham line drawing 
algorithm, using a pen-up, pen-down approach. The user may specify a pattern 
of an arbitrary length or use a predefined default pattern (dash-dot, dotted, etc.). 
All pattern segments (and their corresponding offsets) can be adjusted according 
to the angle at which the line is drawn. 



Note: If the brush pointer is null, or The line is drawn in the pixrect indicated by pr, with endpoints at (xO , yO) 

vectoMs drawn ° r 1 ’ 3 single width and (xl , y 1). The brush field is a pointer to a structure of type pr_brush 

av ? which holds the width of the line segments to be rendered. If the brush pointer 

is null, or if width is 0 or 1, a single width vector is drawn. The pr brush 
structure is defined in the include file <pixrect /pr_line . h> as follows: 

typedef struct pr_brush { 
int width; 

} Pr_brush; 



Note: If the tex pointer is null, a 
solid vector is drawn. 



The tex field is a pointer to a structure of type pr_texture. If the tex 
pointer is null, a solid vector is drawn. 
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The pr_texture structure is defined in the include file 

<pixrect /pr_line . h> as follows (fields that begin with the prefix res_ 

are reserved for program internals, and are not user-definable): 

typedef struct pr_texture { 
short *pattern; 
short offset; 

struct pr_texture_options { 
unsigned startpoint : 1, 
endpoint ; 1, 
balanced : 1, 
givenpattern : 1, 
res_fat : 1, 
res_poly: 1, 
res_mvlist : 1, 
res_right : 1, 
res_close : 1; 

} options; 
short res_polyoff; 
short res_oldpatln; 
short res_fatoff; 

} Pr_texture; 

pattern is a pointer to an array of shorts which contains the length of each 
segment in the pattern. The lengths are in units of pixels. If the line is drawn at 
an angle, the lengths drawn can be adjusted (the givenpattern field set to 0) 
to correspond to the length of the pattern if a horizontal or vertical line was 
drawn. This array must be null-terminated. The first segment of the pattern 
array is assumed to be pen-down, and following segments alternate. 

The addresses of the following predefined pattern arrays may be stored in the 
pattern field of the texture structure as well: 

extern short pr_tex_dotted [] ; 
extern short pr_tex_dashed [] ; 
extern short pr__tex_dashdot [] ; 
extern short pr_tex_dashdotted[] ; 
extern short pr_tex_longdashed [ ] ; 

The user-defined elements of the pattern array are not altered within the rou- 
tine, supporting multiple calls using the same pattern, of f set is an integer 
offset into the pattern, specified in pixels. Since the first segment of the pat- 
tern array is assumed to be pen-down, you must specify an offset to start on 
a pen-up segment, of f set is adjusted according to the angle at which the line 
is drawn if the original pattern was adjusted (dependent upon the givenpat- 
tern bit, described later). Because of integer approximation, the adjusted 
offset could vary plus or minus one pixel from the exact adjusted offset. 

In the options bit fields, if startpoint is set, the first point is always drawn, 
and if endpoint is set, the last point is drawn; if these are not specified, the 
line will be drawn with no extra pixels set. The balanced bit field effectively 
centers the pattern within the line by computing an offset into the pattern. If the 
givenpattern bit is set, the pattern is drawn without true length correction, at 
any angle; this increases performance. However, the pattern of radiating lines 
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Draw Textured or Solid 
Polylines with Width 



Draw Multiple Points 



from a common center will form concentric squares instead of circles. If the 
givenpattern bit is not set, the segment length of each element of the pattern 
is adjusted according to the angle at which the line is drawn. The true (angle- 
dependent) segment lengths are computed for one period of the pattern, using an 
incremental algorithm which approximates the formula: 

angle _pattern_length — given _pattern_length * cos {angle) 
where all units are in pixels, and angle is measured from the positive x-axis. 

Since the algorithm angle-corrects for one period of the pattern, the longer the 
period, the more exact the results will be. 

The op argument specifies the raster operations used to produce destination pixel 
values and color. 

pr_polyline (dpr, dx, dy, npts, ptlist, mvlist, brush, tex, op) 

struct pixrect *dpr; 

int dx, dy, npts; 

struct pr_pos *ptlist; 

u_char *mvlist; 

struct pr_brush *brush; 

struct pr_texture *tex; 

int op; 

pr_polyline draws a polyline, or a series of disjoint polylines, using the 
features available in pr_line. The polyline is drawn in the destination pixrect 
indicated by dpr, with dx and dy being the offset into the destination pixrect 
for vertices to be translated in x and y, respectively, npt s is the number of ver- 
tices in the polyline (which is always the number of lines plus 1). The ptlist 
field is an array of npts structures of type pr_pos (which hold vertices). The 
mvlist field is a pointer to an array of npts elements in which if any element 
after the first is non-zero, a segment is not drawn to that vertex. The first element 
of the mvlist array controls whether the polyline(s) are automatically closed; if 
set, each continuous polyline is closed. If disjoint polylines are not desired (no 
mvlist is specified), the constants POLY_CLOSE and POLY_DONTCLOSE 
determine this behavior. POLY_CLOSE and POLY_DONTCLOSE are defined as 
follows: 

tdefine POLY_CLOSE ( (u_char *) 1) 

#define POLY_DONTCLOSE < (u_char *) 0) 

The brush field is a pointer to a structure of type pr_brush, and the tex field 
is a pointer to a structure of type pr_t exture. If the tex pointer is null, a 
solid vector is drawn. If the brush structure is null, single- width vectors are 
drawn, op specifies the raster operations used to produce destination pixel 
values and color, brush and tex are described in detail under pr_line. 

pr_polypoint (dpr, dx, dy, npts, ptlist, op) 

struct pixrect *dpr; 

int dx, dy, npts; 

struct pr_pos *ptlist; 

int op; 

The pr_polypoint routine draws an array of points on the screen under the 
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Plane Groups — Addenda 



Determine Supported Plane 
Groups 



control of the op argument. The array of points is drawn in the destination pix- 
rect dpr , with an offset specified by the arguments dx and dy. Npt s is the 
number of points to be rendered, and pt list is a pointer to an array of struc- 
tures of type pr_pos, which hold the vertices for each point. Color is encoded 
in the op argument. Portions of the array outside the pixrect are clipped unless 
the PIX_DONTCLIP flag is set in the op argument. 

If npts is negative, pr_polypoint fails, and PIX__ERR is returned. 

Chapter 2, Pixrect Operations, should include a new section on Plane Groups 
that describes the following routines. 

A plane group is a subset of a frame buffer pixrect Each plane group is a collec- 
tion of one or more related bit planes with stored state (plane mask, color map, 
etc.). Each pixrect has a current plane group which is the target of attribute, 
color map, and rendering operations. 

A plane group is described by a small constant in the include file 
<pixrect/pr_planegroups .h>: 



#def ine PIXPG_CURRENT 0 
#def ine PIXPG_MONO 1 
#def ine PIXPG_8BIT_COLOR 2 
#def ine PIXPG_OVERLAY_ENABLE 3 
#def ine PIXPG OVERLAY 4 



Plane group 0 is the currently active plane group for the pixrect. In the initial 
implementation, the plane group is encoded as a 7-bit field in the pixrect attribute 
word. 

You should assume that all implemented plane groups with non-zero plane 
masks are active. Be sure to explicitly disable plane groups which are not in use 
by setting their plane masks to zero with pr_set_planes (described later). 

ngroups = pr_available_plane_groups (pr, maxgroups, groups); 

Pixrect *pr; 

int maxgroups; 

char groups [maxgroups] 

pr_available_plane_groups provides a means by which you determine 
which plane groups are supported by the machine you are working on. 
pr_available_plane_groups fills the character array groups with true 
(1) values for the plane groups implemented by the pixrect pr. The entry for the 
current plane group (groups [ 0 ] ) array is always set to false (0). The size of 
groups is passed to the function as maxgroups to avoid overwriting the end 
of the array. 

pr_available_jplane_groups returns the index of the highest-numbered 
implemented plane group plus one. 
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Get Implemented Plane Group group = pr_get_plane_group (pr) ; 

Pixrect *pr; 

pr_get_plane_group returns the current plane group number for the pixrect 
pr. If the current plane group is unknown, the function returns 
PIXPG_CURRENT. 

Set Plane Group and Mask void pr_setjplane_group (pr, group); 

Pixrect *pr; 
int group; 

void pr_set_planes (pr, group, planes) 

Pixrect *pr; 
int group; 
int planes; 

pr_set_plane_group sets the current plane group for the pixrect pr to the 
value given by group. If this plane group is PIXPG_CURRENT or unimple- 
mented, pr_set_plane_group does nothing. 

The pr_set_j? lanes function is equal to a pr_set_plane_group (pr , 
group) followed by pr^put attribute s (pr, Splanes). planes 
contains a bitplane write-enable mask. Only those planes corresponding to mask 
bits having a value of 1 will be affected by subsequent pixrect operations. How- 
ever, these planes can still be read. 

Memory Pixrects — Errata Page 36 

Section 4.2, Create Memory Pixrect should be corrected to include the fol- 
lowing proviso: 

In a future release, memory pixrects created with mem_create on a 
32-bit system will have each line padded to a 32-bit boundary, unless it 
is only 16 bits wide; that is, the md_linebytes structure member 
will contain either 2 or a multiple of 4. Non-pixrect code which 
operates on memory pixrect data should examine md_linebytes 
instead of relying on the mpr_linebytes macro. 

If it is necessary to create a memory pixrect with rows padded to 16-bit 
boundaries, the mem_j?oint function should be used. 

Pages 37-38 

Section 4.4, Pixel Layout in Memory Pixrects should be corrected to read as 
follows: 

Currently, memory pixrects are only supported for pixels of 1, 8, 16, or 
32 bits (not 24 bits). Some operations may not work for 16-bit and 32- 
bit pixels. 
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SunCGI Reference Manual 



The following pages are Errata and Addenda for Sun Release 3.0 version of the 
SunCGI Reference Manual — Part Number: 800-1256 



6.2. Graphics: SunCGI 
Reference Manual — 
Errata 



1) In Chapter 2 of the SunCGI Reference Manual, many functions are listed as 
possibly generating error ENOTCCPW[l 12]. This is correct, but the message 
is incorrect. The message should be: 

ENOTCCPW [112] Function or argument not compatible with CGIPW 
mode. 

2) EVALOVWS[69] is no longer detected by pixel_array, 
cgipw_pixel_array or inquire_j?ixel_array. pixel_array 
and cgipw_pixel_array merely clip their output. 
inquire_pixel_array returns a 0 for array entries outside the view sur- 
face. 

3) The example program in Figure G-l of the SunCGI Reference Manual has an 
incorrect call to cf openvws. Figure 6-1 below contains a new example 
program. In addition Table G-4 had an erroneous description of the 

cf openvws function. Table 6-1 contains a new description of this function. 



Figure 6- 1 Example CGI FORTRAN Program 
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program test 

parameter (ibignum=256) 

integer name 

character screenname* (ibignum) 

character windowname* (ibignum) 

integer windowfd 

integer retained 

integer dd 

integer cmapsize 

character cmapname* (ibignum) 

integer flags 

character ptr* (ibignum) 

integer noargs 

c coordinates of glass 

integer xc (10) ,yc (10) , n 
c coordinates of waterline, 

integer xc2 (2) ,yc2 (2) 

data xc /0, -10, -1,-1, -15, 15, 1, 1, 10, 0 / 
data yc /0, 0, 1, 20, 35, 35, 20, 1, 0, 0 / 
data xc2 /-12,12/ 

data yc2 /33,33/ 

c open cgi 

call cfopencgiO 
c open a color pixwin 

dd = 5 

call cf openvws (name, screenname, windowname, 

+ windowfd, retained, dd, cmapsize, cmapname, 

+ flags, ptr, noargs) 
c reset VDC space 

call cfvdcext (-50,-10, 50, 80) 
c draw martini glass and waterline 

n = 10 

call cfpolyline (xc,yc,n) 
n = 2 

call cfpolyline (xc2,yc2,n) 
c sleep for 10 seconds 

call sleep (10) 
c close and exit 

call cfclosecgiO 
call exit() 
end 

< ) 
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Table 6- 1 SunCGI Fortran Binding - Part IV 

CGI Specification Name Fortran Binding 

Open View Surface call cfopenvws (name, screenname , windowname, 

(SunCGI Extension) 1 windowf d, retained, dd, cmapsize, 

2 cmapname, flags, ptr, noargs ) 

integer function cfopenvws (name, screenname, windowname, 

1 windowf d, retained, dd, cmapsize, cmapname, flags, 

2 ptr, noargs) 
integer name 

character* (*) screenname 
character* (*) windowname 
integer windowfd 
integer retained 
integer dd 
integer cmapsize 
character* (*) cmapname 
integer flags 
character* (*) ptr 
integer noargs 
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nr cP 1 The following are Errata and Addenda for Sun Release 3.0 version of the SunCore Reference Manual — Sun 
Part Number: 800-1257 



Section 2.5, page 21. 



SunCore uses the SunView notifier to deal with signals. A program that uses 
the SunCore library should not use the signal ( ) call. For more information 
see the SunView Programmer’ s Guide. 

Note: The SIGWINCH (SIGnal WINdow Change) signal is received via the Sun- 
View notifier to indicate to SunCore that graphical images may need to be 
redrawn. The notify function used by SunCore is _core_winsig. 

Application programs that wish to 
do their own signal handling should 
ensure that _core_winsig is 
invoked as well. 



6.3. Graphics: SunCore 
Reference Manual — 
Errata 

Handling Signals with 
SunCore (SunCore Extension) 



SunCore View Surfaces 
View Surface Types 



Appendix B, page 119. 
cgldd 

The Sun-1 color graphics display used as a raw device. 
cg2dd 

The Sun-2 or Sun-3 color graphics display used as a raw device. 

cg4dd ' 

The on-board color frame buffer used as a raw device. ; . 

pixwindd 

A monochrome (one bit deep) graphics window within the SunView win- 
dow environment. This window may appear on either a color or mono- 
chrome display. 

cgpixwindd 

A color graphics window within the Suntools window environment. This 
window must appear on a color display. 
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gpldd 

A Sun-2/ 160 or Sun-3/ 160 graphics display with a Graphics Processor 
option. 

gplpixwindd 

A color graphics window within the Suntools window environment running 
on a Sun-2/ 160 or Sun-3/ 160 color graphics display with a Graphics Proces- 
sor option. 

Only view surface types cgldd, cg2dd, cg4dd, cgpixwindd gpldd, and 
gplpixwindd support hidden surface removal. In the discussion above, gray 
scale devices are considered to be color devices. 

The term ‘raw device’ above implies that the physical device specified by 
vwsurf . screenname is used completely and only for display of graphics 
output directed to one view surface. This allows somewhat more efficient 
display of output primitives. It also implies that the user has not started up a 
Suntools window environment using the device as a desktop. 

Low-level device-dependent routines are not part of SunCore. For efficiency, 
such routines are necessary for some applications. The Pixrect Reference 
Manual contains information on low-level routines corresponding to bwldd, 
bw2dd, cgldd, cg2dd, cg4dd and gpldd, (die ‘pixrect’ level) and 
pixwindd, cgpixwindd and gplpixwindd (the pixwin level). 



View Surface Specification for 
Window Devices 



Section B. 4.2, page 127. 

An example of a program that opens multiple view surface follows. This section 
describes the mechanism that SunCore uses to decide which window to use for a 
new view surface of types pixwindd, cgpixwindd and gplpixwindd. 

SunCore first checks to see if there is a window name (e.g /dev/win5) 
specified in vwsurf . windowname. If so SunCore will try to open that win- 
dow directly. 

Note: SunCore allows the user to open multiple view surfaces on the same win- 
dow in this manner. While this is not flagged as an error, it is of questionable 
value. Each view surface would obscure the graphical contents of previous ones. 

Otherwise, the WINDOW GFX environment variable is used to determine which 
window to open. SunCore tests whether any surface has already been opened by 
this method. If WINDOW GFX has already been used in this manner, the pro- 
gram /usr /lib/view_surf ace is invoked to create a new window on the 
same physical display device as WINDOW GFX . This new window becomes the 
view surface. Thus, if a SunCore program is run from the tty subwindow of a 
Graphics Tool , the first default view surface will occupy the display space 
covered by the graphics subwindow of the tool. Subsequent default view sur- 
faces will appear as graphics windows, each within a separate View Surface Tool 
on the same screen as the Graphics Tool. 

This SunCore program takes two arguments that contain window names of the 
form /dev/win???. Two corresponding view surfaces are opened. Vertical 
vectors are drawn in the first view surface, horizontals in the second. It was 
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written to run on monochrome windows - change references of pixwindd to 
cgpixwindd or gplpixwindd if appropriate. (Window names can be 
obtained by entering echo $WIND0W_ME in a window). 

♦include <usercore.h> 

♦include <stdio.h> 



int pixwindd ( ) ; 

struct vwsurf vwsurf 1 = DEFAULT__VWSURF (pixwindd) ; 
struct vwsurf vwsurf 2 = DEFAULT_VWSURF (pixwindd) ; 

main(argc, argv) 
int argc; 
char *argv[]; 

{ 

register int i; 
if (argc<3) { 

fprintf (stderr, "Usage: %s /dev/win? /dev/win?0, argv[0]); 
exit (1) ; 

} 



} 



initialize_core (BASIC, NOINPUT, TWOD) ; 
strncpy (vwsurf 1 .windowname, argv[l], DEVNAMESIZE) ; 
initialize_view_surface (Svwsurf 1, FALSE) ; 
strncpy (vwsurf 2 .windowname, argv[2], DEVNAMESIZE); 
initialize_view_surface (&vwsurf2, FALSE) ; 
set_window (-100 . 0, 100.0, -100.0, 100.0); 
srandom(getpid() ) ; 

if (select_view_surface (&vwsurf2) ) 

fprintf (stderr, "Cannot select second view surface"); 
set_viewport_2 (0 . 0, 1.0, 0.0,. 75); 
create_retained_segment (101) ; 
for (i=0; i<41; i++) { 

move_abs_2 (-100 . 0, -100.0 + 5 * i) ; 
line_abs_2 (100 . 0, -100.0 + 5 * i) ; 



1 

close_retained_segment (101) ; 
deselect_view_surf ace (&vwsurf2) ; 
if (select_view_surface (fivwsurf 1) ) 

fprintf (stderr, "Cannot select first view surface"); 
set_viewport_2 (0 . 0, 1.0, 0.0,. 75); 
create_retained_segment (100) ; 
for (i=0; i<41; i++) { 

move_abs_2 (-100 . 0 + 5 * i, -100.0); 
line abs 2 (-100.0 + 5 * i, 100.0); 



} 

close_retained_segment (100) ; 
deselect_view_surf ace (&vwsurf 1) ; 
sleep (10) ; 
terminate core () ; 



The following example program replaces the program in Figure B-3 in the SunCore Reference Manual. 
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♦include <sunwindow/window_hs .h> 

♦include <sys/file.h> 

♦include <sys/ioctl .h> 

♦include <sun/fbio.h> 

♦include <stdio.h> 

♦include <usercore.h> 

int bwldd() ; /* All device- independent /device-dependent */ 
int bw2dd() ; /* routines are referenced in this function. */ 
int cglddO ; /* This means the linker will pull in all of them. */ 
int cg2dd() ; 
int cg4dd() ; 
int gpldd ( ) ; 
int pixwindd ( ) ; 
int cgpixwindd ( ) ; 
int gplpixwinddO ; 

static char *devchk; 
static float glassdx[ ] = { 
static float glassdy[ ] = { 
static int devhas windows; 
static struct vwsurf nullvs 

main(argc, argv) 
int argc; 
char **argv; 

{ 

struct vwsurf vwsurf; 

initialize_core (BASIC, NOINPUT, TWOD) ; 
if (get_view__surface (Svwsurf , argv) ) 
exit (1) ; 

initialize_view_surface (Svwsurf , FALSE) ; 
select_view_surface (Svwsurf ) ; 
set_viewport_2 (0 . 125, 0.875, 0.125, 0.75); 
set_window (-50 . 0, 50.0, -10.0, 80.0); 
create_temporary_segment () ; ' 
move_abs_2 (0.0, 0.0); 
polyline_rel_2 (glassdx, glassdy, 9) ; 
move_rel_2 (-12 . 0 , 33.0); 
line_rel_2 (24 . 0, 0.0); 
close_temporary_segment () ; 
sleep (10) ; 

deselect_view_surface (&vwsurf ) ; 
terminate_core () ; 

} 

/* 

* get_view_surface — Determines from command-line arguments and the 

* environment a reasonable view surface for a SunCore program to run on. 
*/ 

int get_view_surface (vsptr, argv) 
struct vwsurf *vsptr; 



-10.0, 9.0,0.0,-14.0,30.0,-14.0,0.0, 9.0, -10.0 }; 
0.0,1.0,19.0,15.0,0.0,-15.0,-19.0,-1.0,0.0 }; 

= NULL VWSURF; 
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char **argv; 

{ 

int devfnd, fd, fbtype, chkdevhaswindows () ; 
char *wptr, dev [DEVNAMESIZE] , *getenv(); 
struct screen screen; 



*vsptr = nullvs; 
devfnd = FALSE; 

/* 

* If command line arguments are passed, process them using 

* win_initscreenf romargv ( ) (see the "SunView System Programmer's 

* Guide") . The only option used by get_view_surface is the -d 

* option, allowing the user to specify the display device on 

* which to run. 

*/ 

if (argv) { 

win_initscreenf romargv (Sscreen, argv) ; 
if (screen . scr_fbname [0] ! = ' ') { 

/* -d option was found */ 
devfnd = TRUE; 

strncpy(dev, screen . scr_fbname, DEVNAMESIZE); 

/* 

* Check to see if this device has a window system 

* running on it. If so devhaswindows will be TRUE 

* following the call to win_enumall. win_enumall is 

* a function in libsunwindow.a . It takes a function 

* as its argument, and applies this function to 

* every window being displayed on any screen by the 

* window system. To do this it opens each window 

* and passes the windowfd to the function. The 

* enumeration continues until all windows have been 

* tried or the function returns TRUE. 

*/ 

devchk = dev; 
devhaswindows - FALSE; 
win_enumall (chkdevhaswindows) ; 

} 

} 

if ( ! devfnd) 

/* No -d option was specified */ 
if (wptr = getenv ("WINDOW_ME") ) { 

/* 

.* Running in the window system. Find the device 

* from which this program was started. 

*/ 

devhaswindows = TRUE; 

if ( (fd = open(wptr, 0_RDWR, 0)) < 0) { 

fprintf (stderr, "get_view_surface : Can't open %s0, wptr); 
return (1) ; 

} 

win_screenget (fd, Sscreen) ; 
close (fd) ; 

strncpy(dev, screen. scr_fbname, DEVNAMESIZE); 
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} else { 

/* 

* Not running in the window system. Assume device 

* is /dev/fb. 

*/ 

devhas windows = FALSE; 

strncpy(dev, ”/dev/fb", DEVNAMESIZE) ; 

} 

/* Now have device name. Find device type. */ 
if ( (fd = open(dev, 0_RDWR, 0)) < 0) { 

fprintf (stderr, "get_view_surf ace : Can't open %s0, dev); 
return (1) ; 

} 

if ( (fbtype = pr_getfbtype_f rom_fd (fd) ) == -1) { 

fprintf (stderr, "get_view_surf ace : pr_getfbtype_f rom_fd () failed for %s0, dev); 
close (fd) ; 
return (1) ; 

} 

close (fd) ; 

/* Now have device type and know if window system is running on it . */ 
if (devhaswindows) 

switch (fbtype) { 
case FBTYPE_SUN1BW: 
case FBTYPE_SUN2BW: 

vsptr->dd = pixwindd; 
break; 

case FBTYPE_SUN1C0L0R : 
case FBTYPE_SUN2 COLOR : 
case FBT YPE_SUN4COLOR : 

vsptr->dd — cgpixwindd; 
break; 

case FBTYPE_SUN2GP : 

vsptr->dd = gplpixwindd; 
break; 
default : 

fprintf (stderr, "get_view_surf ace : %s is unknown fbtypeO, dev) ; 
return (1) ; 

} 

else 

switch (fbtype) { 
case FBTYPE_SUN1BW: 

vsptr->dd == bwldd; 
break; 

case FBTYPE_SUN2BW: 

vsptr->dd = bw2dd; 
break; 

case FBTYPE_SUN1C0L0R: 
vsptr->dd = cgldd; 
break; 

case FBTYPE_SUN2COLOR: 
vsptr->dd = cg2dd; 
break; 

case FBTYPE SUN4COLOR: 
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vsptr->dd = cg4dd; 
break; 

case FBTYPE_SUN2GP : 

vsptr->dd = gpldd; 
break; 
default : 

fprintf (stderr, "get_view_surf ace : %s is unknown fbtypeO, dev); 
return (1) ; 

} 

/* Now SunCore device driver pointer is set up. */ 
if ( ! devhaswindows | | devf nd) 

/* 

* If no window system on device or -d option was specified, 

* tell SunCore which device. Otherwise, let SunCore figure 

* out the device itself from WINDOW_GFX so the default 

* window will be used if desired. 

*/ 

strncpy (vsptr->screenname, dev, DEVNAMESIZE) ; 
return (0) ; 

} 

static int chkdevhas windows (windowfd) 
int windowfd; 

{ 

struct screen windowscreen; 

win_screenget (windowfd, Swindowscreen) ; 

if (strcmp (devchk, windowscreen. sc r_fbname) == 0) { 

/* 

* If this window is on the display device we are checking, 

* set the flag TRUE. Return TRUE to terminate the enumeration. 

*/ 

devhaswindows = TRUE; 
return (TRUE) ; 

} 

return (FALSE) ; 

} 



Asun 

microsystems 



Revison A of 10 October 1986 





1 14 SunCore Reference Manual 



Windows & Window Based Tools: Beginner’s Guide 



The following pages are Errata and Addenda for Sun Release 3.0 version of the Windows & Window Based Tools: 
Beginner’s Guide — Sun Part Number: 800-1287. 

D 27 

Subwindow resizing p * 

After Resizing a window in section 3.1, add: 

Resizing subwindows Many tools are composed of more than one window. The windows in such 

tools are more properly referred to as subwindows. For example in mail- 
tool there is a subwindow for message headers, a subwindow with various 
control buttons and a subwindow for the display of the current message. 

You can adjust the size of subwindows in a tool, for example to see more 
message headers in mailtool. This is a window manipulation that can- 
not be performed from the frame menu; you have to use an accelerator. To 
resize subwindows, move the cursor into the border of the subwindow you 
want to resize so that the target circle cursor appears, hold down the 
( CTRL! key, and press the middle mouse button. Depending on where the 
cursor is on the subwindow border, the cursor will turn into one of the same 
constrained or unconstrained resizing cursors you see when resizing tools. 
Then move the mouse until the sub window is the desired size. You cannot 
make a subwindow bigger than the tool it is in. 

The above is the most common resizing operation. There are others: 

□ Similar to moving the frame itself, you can move a subwindow within the 
frame without resizing it by moving the cursor onto the border between two 
subwindows, holding down the middle mouse button, and moving the cursor 
to the desired position. You can use this to change the order of subwindows 
in a tool — for example putting the scratch window in textedit at the 
bottom instead of the top. 

□ By holding down the ( SHIFT 1 key when moving OR resizing subwindows, 
the other subwindows will not adjust to fill any empty space that results. 

You have little reason to use this feature except when moving subwindows 
around to a new layout. 

Many tools with multiple subwindows allow you to specify the sizes of the dif- 
ferent subwindows in advance, either in defaults edit or through command 



Advanced subwindow 
adjustments 
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shelltool arrow keys 



New 

i npu t_f r om_de faults 

program 



textedit menu out of date 



line options. 

Note: Some tools handle the resizing of subwindows better than oth- 
ers, so be cautious in shrinking or expanding subwindows too much. 



p. 62 

In section 7.4, add: 

By default the keys I R8 1 . 1 RIO) . ( R121 and, [ R141 on the Sun-2 and Sun-3 
keyboard act like arrow keys in terminal-based applications such as vi 
unless you use the setkeys noarrows option or set Arrow Keys in 
def ault sedit. For more information on changing these keys’ function, 
see section 16.2. 



p. 69 

In section 8.1, add: 

In 3.2 there is a new way to set your keyboard function key preferences that 
obsoletes setkeys. There is a new category, Input, in default sedit 
that lets you specify the option Left_Handed. When you I Save 1 your 
changes in def ault sedit, the program input_from_defaults is 
run to change the current input settings to your preferences; it automatically 
determines and sets your keyboard type at the same time. If you specify 
LeftHanded then it also swaps the left and right mouse buttons. 

You can run the program input_from_de faults to change the set- 
tings before you mn suntools. You can modify the sample lines for 
your . login in section 2.4, Starting suntools Automatically Upon 
Login, so that input_f rom_def ault s is run before you start sun- 
tools. 

N Ote: When youchange the input settings using setkeys, 
defaultseditor i npu t_f r om_de faults the change affects all 
windows, not just text subwindows, and it takes place immediately, even if 
someone else is running suntools. It remains in effect until one of the 
programs is rerun or the machine is restarted. 



The text menu shown in Figure 8-4 is out of date. The text menu includes 
the item Put then Get documented in section 9.1. 
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Keyboard equivalent for Put p. 83 

Under Copying a Selection in section 8.3, change 

The 1 Put! function key (usually 1 L 6 ) ) stores selected characters on the 
shelf without deleting them. 

to 

The ( Putl function key (usually 1 L6 ) ), or ! CTRL-PI . stores selected 
characters on the shelf without deleting them. 



Search-and-Replace of text p. 113 

At the end of The Again Operation in section 9.2 add: 

Another common operation that can be accelerated by using the ( A gain ) key 
is searching for a string and replacing it One way to do this is to select the 
string to search for, 1 Find 1 (if you selected the string in the same window 
then this will jump to the next instance of the string), 1 Delete 1 , type replace- 
ment string. Then press t Again 1 and the Find-Delet ^-replacement string 
operation will be repeated. 

Pressing t A gain I will do nothing if text edit can’t find any more strings. 
If an unwelcome replacement occurs, press I Undo 1 and continue with 
[Againj. 



Checkpointing in text edit p. 115 

In section 9.6 add: 

You can avoid losing more than a small amount of changes that you make 
while editing by specifying the checkpoint N option to textedit; 
see the following errata on Checkpoint Jrequency. 

p. 116 

In section 9.8 add: 

Checkpoint_frequency integer 

If Integer is non-zero, the file you are editing 
will periodically be copied to a file with the 
same name with % % on the end. This will 
occur after every Integer edits to the file; 
each character insertion or text operation 
counts as an edit The entire file is copied to 
this backup file, so this serves as an extra pro- 
tection against losing critical work. To 
recover from a crash you need only copy the 
filename%%, losing at most the last Integer 
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changes to the file. The creation of this 
backup file is a separate process from the 
filename % file that textedit creates when 
you save a file (see textedit’s Backup 
Files in the previous chapter). The default is 
0 which means that checkpointing is dis- 
abled. 



Command line arguments to 

textedit 



p. 115 

In section 9.8, after 

You can specify a number of options to the text facility using 
defaultsedit. 



add: 



You can also set many of these options as command line options when 
you start up textedit (and cmdtool). This allows you to have 
different settings from your defaults in particular textedit tools. 
See the textedit (1) man page for more information. 



List of keyboard equivalents p. 117 

Section 9.9, Summary of Text Facility, should be modified as follows: 

Add after Bracket a selection : 

Copy primary selection to caret 

Choose Put then Get from the menu, or 
use the accelerator I CTRL-P I . 

Go to end of text 1 c:i KL-KfcTUKN 1 moves the insertion point 

to the end of the text, positioning the text so 
that the insertion point is visible. 



Replace 

GSD (Usually (2HD) 

with 

C3ID (Usually COD ) or ( CTRL-0 1 
Similarly, 

( CTRL-Pl is a keyboard equivalent for i Put) . [ CTRL-D ) is a keyboard 
equivalent for 1 Delete ) and 1 CTRL-F 1 is a keyboard equivalent for I Find ) . 
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Checkpointing in cmdtool p.124 

At the end of section 10.2, add 

You can use the same checkpoint facility in cmdtool that exists for 
textedit to safeguard important files. Turn on checkpointing by setting 
Checkpoint _frequency in the Tty category in def aultsedit to some 
non-zero value. See the errata section for textedit above for more 
information about checkpointing. 



New defaultsedit look p. 127 

In section 11.1 add 

defaultsedit (1) looks different in 3.2. The different categories of 
options are available from a single Category choice item. Click the left 
mouse button on Category to cycle through the categories available or 
hold down the right mouse button to see a menu of categories. 

There is a new category, Input which allows you to tailor keyboard function 
key usage (previously set using set keys), mouse responsiveness several 
mouse and keyboard settings. When you 1 Save 1 your defaults, the program 
input_f rom_def ault s is run to load your new settings. See the errata 
for section 8. 1 for more information. 



Modifying subwindow 
behavior in cmdtool 



p. 166 

After section 16.2 add the following 

cmdtool reads both . ttyswrc and . text swrc; the latter overrides 
the former in cases where the same function key is mapped in both. 
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FORTRAN Programmer’s Guide 



The following pages are Errata and Addenda for Sun Release 3.0 version of the 
FORTRAN Programmer’ s Guide — Sun Part Number: 800-1371. 



6.4. Developing and 
Maintaining 
FORTRAN Programs 
— Errata 



Page 9 

Insert the following line at the bottom of the page: 

• f 7 7 permits a maximum of 19 contiguous continuation lines 

Page 20 

Replace the subroutine named start upcore . f with the following: 
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subroutine startupcore 

include ' /usr/include/f 77/usercore77 . h' 

C make initializing calls to core library 

common /vwsurf/ vsurf 

integer vsurf (VWSURFSIZE) , SelectVwsurf 

integer pixwindd, InitializeCore, InitializeVwsurf 
C (Use cgpixwindd instead of pixwindd to run with color) 

external pixwindd 
character* 4 envreturn 
character*50 sccsid 
integer loc 

data sccsid/ (#) startupcore . f 1.1 84/03/05\n"/ 

data vsurf /VWSURFSIZE*0/ 

vsurf (DD INDEX) = loc (pixwindd) 

if (InitializeCore (BASIC, NOINPUT, TWOD) .ne.O) call exit 
call getenv( ”WINDOW_ME", envreturn ) 
if (envreturn .eq. " ") then 

write (0, *) "must run in a window" 
call exit (2) 
endif 

if (InitializeVwsurf ( vsurf, FALSE) .ne. 0) call exit (2) 

if (SelectVwsurf (vsurf ) -ne. 0) call exit (3) 

call SetWindow( -1.5, 1.5, -2.0, 2.0 ) 

call CreateTempSeg () 

return 

end 



subroutine closecore 

include ' /usr/include/f77/usercore77 .h' 

C make terminating calls to core library 

common /vwsurf/ vsurf 
integer vsurf (VWSURFSIZE) 

call CloseTempSeg () 

call DeselectVwsurf ( vsurf ) 

call TerminateCore () 

return 

end 

s ) 



6.5. Input and Output — 
Errata 



Page 48 

Insert the following paragraphs at the end of the page: 

FORTRAN unformatted IO is generally not used very much. There are two 
kinds of unformatted IO: sequential and direct. 
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6.6. The Run Time 
Environment — 
Errata 



Sequential unformatted IO, like sequential formatted IO, is record oriented: 
each read reads exactly one record, each write writes exactly one 
record. But since the UNIXf file system has no records, how does FORTRAN 
find out where the record boundaries are? The information is represented in 
the data. 

In formatted files, the end-of-record is denoted by a special character, the 
newline character (octal 012). The newline character is not accessible to the 
FORTRAN program, but is inserted or filtered-out as appropriate, by the run- 
time system. While it would be nice to have an analogous separator for 
unformatted records, but there are no characters that can be unambiguously 
differentiated from unformatted data. For example, the newline character 
could be confused with an integer value of 10. 

Proceeding and following each unformatted sequential record is an 
integer*4 byte count. The trailing byte count is used to permit back- 
space to operate on records. How do those counts get there? 

FORTRAN inserts the byte counts when writing records to files connected for 
unformatted sequential IO. The result is that FORTRAN programs cannot 
use an unformatted sequential read to read any data not written by an 
unformatted sequential write operation. So, if the first byte of your data 
file is "4", an unformatted sequential read will interpreted it as the first 
byte of a count, which thus has to be at least 0x4000000! This is probably 
not what was intended. 

Direct unformatted IO, like sequential unformatted IO, is record oriented. 
But because you have to specify the record size in the open statements 
reel clause, the record length information is not buried in the file data. 
Since each transfer involves an integral number of records, you have to be a 
careful: 

According to the FORTRAN specification, on input exactly one record 
is read. On input, the number of values required by the input list must be 
less than or equal to the number of values in the record. 

As a general rule, avoid using the unformatted sequential read unless the 
file being read was originally written that way. If you want to use unformat- 
ted IO, try to use the unformatted direct read whenever possible, opening 
the file with recl=l if not all your input lists are the same length. 

Page 62 

Replace the definition of the representation of real or double precision 
numbers at the middle of page with the following definition: 

A real or double precision number is represented by the form: 



UNIX is a trademark of AT&T Bell Laboratories. 
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6.7. Deviations from the 
FORTRAN 77 
Standard — Errata 



sign * *\ f 

where/ is the bits in the fraction. 



Replace the definition of the representation of subnormal numbers with the fol- 
lowing definition: 

The form of a subnormal number is 
(-1) * 2 1 ~ bias * O.f 



where/ is the bits in the significand. 

Page 87 

Replace the last sentence in the second paragraph with the following: 

The second part describes areas where this compiler and run time system 
violate the ANSI standard, either because the compiler or run time system 
cannot correctly implement the ANSI standard, or the standard is ambigu- 
ous. These violations seldom affect working programs and are often not 
even recognized by the standard validation tests. 

Page 89 

The section include Statement should have the following paragraphs 
appended to it: 

If the name referred to by the include statement begins with the charac- 
ter 7’, it is taken by f 7 7 to mean the absolute pathname of the include file. 

Otherwise, the f 77 looks first for the include file in the directory contain- 
ing the source code file with the include statement. If die file cannot be 
found there, f 7 7 looks for it in / u s r / include . 

Note that files included via #include may contain #def ines and the 
like, while files included with the compiler include statement must con- 
tain only FORTRAN statements. 

Page 91 

Remove the subsection Dummy Procedure Arguments. 

Remove the subsection Assigned goto. 

Remove the subsection Default files. 

Page 92 

Remove the subsection Exponent representation on Ew.dEe output. 
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Pascal Programmer’s Guide 



The following pages are Errata and Addenda for Sun Release 3.0 version of the 
Pascal Programmer’ s Guide — Sun Part Number: 800-1376. 

Sun Extensions to Berkeley ^ 

Pascal Insert the following subsection immediately before section 8.3: 

Logical AND Token 

The character "&" can be used in programs to denote a logical AND. 

Page 90 

Append to end of text on page: 

□ Description: The pc preprocessor allows labels greater than 9999. The ISO 
standard limits labels to the range 0-9999. 
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System Administration Manual 



The following pages are Errata and Addenda for Sun Release 3.0 version of the 
System Administration Manual — Sun Part Number: 800-1323. 



6.8. Diag — A Disk This chapter describes diag, the Sun Microsystems standalone disk utility pro- 

Maintenance Program gram. It describes how to start diag, how to prepare a new disk for operation, 

and how to fix problems on a disk. 

6.9. Architecture A disk consists of a stack of spinning platters, each with its own head. The 

heads, which all move together, travel back and forth across the surface of the 
platters between the outer rim of the stack and the center. 

Each platter consists of a series of tracks, which are concentric rings that run 360 
degrees around the platter. Each track is divided into sectors, and each sector is 
marked with a unique header. Sectors are the basic storage units; each sector 
contains 512 bytes of usable data. Sectors are also referred to as blocks. 

A cylinder is a vertical stack of tracks; for example, the third track on all the 
platters in the stack is cylinder 3. Because the heads move together, they are 
always on the same cylinder. 

Diag understands disk addresses in two forms: cylinder/head/sector 
(CC/HH/SS), or absolute decimal block numbers (NNNNNN). Diag accepts 
either, but the CC/HH/SS form resembles the physical architecture of the disk 
more closely. Both forms identify one particular sector. 

A CC/HH/SS address in the form CC/00/00 identifies a cylinder boundary; the 
cylinder starts at sector 0 in track 0. Similarly, each track n 

address in the form CC/HH/00 identifies a track boundary. 

Logical vs. Physical An address can be logical or physical. A logical address represents a count of 

usable sectors from the beginning of the disk, and a physical address represents 
an actual location on the surface of the disk. 

When UNIX reports disk errors, it provides the logical block numbi£||§ the sec- 
tor in error. It is listed by UNIX as the abs blk #. This is generally the actual 
sector that caused the error. However, due to controller hardware limitations, 
this number is occasionally approximate. 



Cylinder, Head and Sector 
Numbers 



#sun 



Nr microsystems 



124 



Revison A of 10 October 1986 




System Administration Manual 1 25 



Partitions and File Systems 



SCSI Interface 



SMD Interface 



Removing Bad Sectors 



SMD Bad Sectors 



Partitions are regions on the disk set up by using the partition and label 
commands. They start on cylinder boundaries and are used by UNIX. 

Diag has built-in partition tables for all standard disk drive configurations plus a 
couple of alternates; you can select these easily using the label command. If 
these are not adequate, the partition command also has a facility for 
developing custom partitions. 

SCSI controllers are attached to the system through a host adapter, which 
presents a bus address where its registers are located. All commands to controll- 
ers pass through the host adapter, and thus through the same bus registers, but a 
particular target controller may be specified. 

Controllers communicate with disks over an ST506 or ESDI interface, and with 
the host adapter over the SCSI bus. Controllers perform all defective sector han- 
dling automatically. This insulates software from the physical details of SCSI 
disks; it sees an idealized device consisting of a continuous stream of sectors. 

The CPU and file system must be more intimately acquainted with the details of 
the SMD disk; the SMD controllers are connected directly to the system bus. 

The CPU writes commands directly to the SMD control registers, and the con- 
troller carries out specified operations by communicating directly with the disk 
using the SMD interface. The device driver needs a lot of knowledge about the 
specific nature of the disk drive, and the filesystem takes advantage of this to 
arrange data on the disk in a way that will provide fast access for reading, writ- 
ing, and updating files. 

All disk surfaces contain some media defects. The sectors where these occur 
must be removed from service to provide reliable operation. 

Practically speaking, new defective sectors should never turn up during operation 
unless you have problems. All disks start life with a few surface defects, but the 
disk drive manufacturer and Sun each perform extensive surface analysis and slip 
or map these. Also, the procedure for preparing a new disk includes a third sur- 
face analysis to catch any surface defects caused during transit 

If you encounter surface defects after all that, it’s usually caused by damage to 
the defective sector map, a “head kiss” where a head actually touches the sur- 
face of the disk, or an electronic glitch, which can corrupt the data on a sector 
making it look like a surface defect. These things usually indicate some underly- 
ing problem; if they happen once, they are likely to happen again. The disk 
troubleshooting section later in this chapter provides instructions for finding and 
fixing these problems 

The following sections discuss defect handling on both SMD and SCSI disks. 

Diag commands deal with defective sectors on an SMD-controlled disk by slip- 
ping or mapping them. Format and fix search a defined area for defective 
sectors. If they find one, they attempt to slip it and if that fails they map it. The 
map command simply maps sectors on request 
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SCSI Bad Sectors — ST506 
Controllers 



SCSI Bad Sectors — ESDI 
Controllers 



6.10. Starting diag 



Disks configured for sector slipping contain a spare data sector at the end of each 
track. When diag attempts to slip a sector, it removes the defective sector from 
service by identifying it with a special header, then it bumps subsequent logical 
sectors forward until the last sector moves to where the spare was. 

If the disk is not configured for sector slipping, or if a track contains a second bad 
sector, you must rely on mapping. Diag writes the defective sector’s address in 
the bad sector map and marks the sector with a header identifying it as a mapped 
sector. When the access to the mapped sector fails, the bad sector map redirects 
UNIX to use another sector on the spares track. 

Sector slipping improves disk efficiency; it allows the disk to operate without the 
additional overhead of mapping. 

To identify slipped sectors, mapped sectors, and to tell if the disk is configured 
for sector slipping, use the rhdr command, described later in this chapter. 

To deal with SCSI disk bad sectors, the ST506 controller marks the bad sector 
and resumes its sector count on the next sector. It then slips the physical loca- 
tions of all subsequent sectors towards the end of the disk. 

As defects add up, the sectors get skewed across cylinder and track boundaries. 
To deal with the difference between where a sector should be and where it has 
slipped to, the controller does a quick scan of the disk when it comes up. It 
divides the disk into zones and keeps a table of the amount of slippage for each 
zone. When it does a seek, it adds the amount of slippage for each zone it has to 
go through, so that it ends up looking somewhere near the desired sector. 

Because slipping requires moving all subsequent sectors on the disk, all of diag’s 
strategies for dealing with defective sectors involve reformatting the disk. When 
it’s finished formatting and slipping sectors, it writes a list of the slipped sectors 
at the end of the disk. 

To deal with SCSI disk bad sectors, the ESDI controller uses a technique similar 
to the SMD controllers. Each track on the disk contains a spare sector. When a 
defective sector is found, it is marked invalid and all subsequent sectors on that 
track are bumped forward one sector. When multiple sectors on a track are 
defective, the controller maps the entire track to a spare at the end of the disk. 
The main difference between an ESDI controller’s defect handling and that of an 
SMD controller is where the intelligence resides. For an SMD disk, all the map- 
pings are handled in software and diag must explicitly write the sector headers 
to perform a slip. For ESDI disks, the software simply tells the controller which 
sectors are defective and the controller handles all the the physical details. 

Diag is a standalone program that lives in stand/ diag. You must boot it 
standalone (without UNIX) from the system monitor. After booting, you must 
then configure diag to match your controller/disk configuration. This section 
provides instructions for both. 
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User Interface 



Booting diag 



Diag responds to commands typed on the workstation keyboard. It contains a 
number of subsystems with different command sets. The prompts for each sub- 
system are different, too; the normal prompt is: 




to remind you where you are. 

A couple of tricks make diag easier to use: 



Restart 

If you exit from diag to the monitor, you can restart it with the monitor 
command: 



r 


\ 


> g4000 




V 


) 



Command Shortening 

You can shorten most diag commands to a single letter, or to the shortest 
unique string of letters. For example, to enter the translate command, 
just type: 



— 


\ 


diag> t 






j 



Diag boots from the PROM monitor’s command interpreter. To activate the 
command interpreter, power-on or reset the system. If UNIX is active, bring it 
down properly (as described in previous chapters) before resetting the system. 
When this message appears: 



s 




Auto-boot in progress 




v 


J 



abort booting and enter the prom monitor. To do this, type ( Ll-A ) on Sun-2 or 
Sun-3 keyboards (while holding down LI, press the A key), or type I BREAK 1 on 
non-Sun and Model 100U keyboards. The monitor should respond by interrupt- 
ing the UNIX bootstrap and displaying its prompt: 
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Configuring diag 



where pathjtame is the path to, and the name of the file to be booted. From a 
formatted, operational disk, use: 

/ \ 

>b stand/diag 

Boot: disk( 0, 0, 0) stand/diag 
Load: disk{0, 0, 0)boot 
Boot: disk( 0, 0, 0) stand/diag 

Size: 34816+20480+1160 bytes [varies by version] 

where dusk = 

xy for a Xylogics controller, 
sd for a SCSI controller, 
ip for an Interphase controller, or 
ec for 3Com, ie for Sun ethernet boards or le 
for Lance ethernet boards. 

. > 



Booting diag from tape requires loading the boot block from tape, then loading 
diag. Normally diag is the fourth file on the tape (file 3 because numbering 
starts at 0). 



/ 







>b tape 

Boot : tape (0,0,0) 

Boot : tape (0,0,3) 

Size: 34816+20480+1160 bytes 


[varies by version ] 




v 




) 



where tape is rat for 1/2" tape with Tapemaster controller, xt for 1/2" tape 
with Xylogics controller, ar for 1/4" Archive tape, and st for 1/4" SCSI tape. 

When diag first starts up, it displays a sign on message: 


Version 2.2 84/08/10 [varies with different versions] 

Disk Initialization and Diagnosis 

When asked if you are sure, respond with 'y' or r Y' 

\ ) 



Earlier versions of diag may not display the version message. These are out- 
dated; use the most recent version you have. 



When diag starts, it automatically enters the diag command subsystem. It 
prompts for required hardware-specific configuration information, then returns to 
the command level. To change the configuration later from the command level, 
enter the command diag. 

Diag needs detailed information about the disk and controller it is working with. 
It has information about standard configurations built in, and it has a facility for 
accepting information about a non-standard disk and controller combination. 

The configuration procedure differs, depending on whether the system is being 
configured for a standard SMD or SCSI interface, or something non-standard. 
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In the following command descriptions, where the example or explanation 
applies to both types of disk, it clearly says so. Ignore sections describing an 
interface type other than yours. 

Configuring for Standard Disks First, diag asks what type of disk controller it’s dealing with: 



specify controller: 

0 - Interphase SMD-2180 

1 - Xylogics 440 (prom set 926) 1 

2 - Xylogics 450/451 

3 - Adaptec ACB 4000 - SCSI/ST506 

4 - Emulex MD21 - SCSI/EDSI 
which one? 2 

' 



This example shows a Xylogics 450/451 (type 2) disk controller. 

Next, diag asks for the controller’s bus address. After you provide an address 

(see the table below for defaults) it echoes back the address provided: 


Specify controller bus address in hex: address from table 
Device address: address you selected 
\ , 



T able 6-2 Controller/Host Adapter Bus Addresses 



Controller Type 


MULTIBUS ADDRESS 


VMEbus ADDRESS 


1st cntrlr 


2nd cntrlr 


1st cntrlr 


2nd cntrlr 


Xylogics 


ee40 


ee48 


ee40 


ee48 


SCSI (Sun-2) 


80000 


84000 


ee2800 


N/A 


SCSI (Sun-3) 


N/A 


N/A 


200000 


N/A 


SCSI (Sun-3/50) 






140000 (on board) 



If you specify a controller which interfaces to a SCSI disk, diag then asks for 
the controller’s SCSI bus unit number: 



— 




Which target? 0 




V 


j 



0 is the target number for the first (or only) SCSI disk controller on a host 
adapter; 1 is the target number for the second. 

Next diag requests the physical unit number of the disk on the controller: 



— 




Which unit? 0 




v 


) 



0 is the correct response for the first (or only) disk drive connected to the 



1 Sun Microsystems no longer officially supports Xylogics 440 controllers. 
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selected controller; 1 is the correct response for the second, and so on. SMD 
disks can be set for unit numbers of 0 to 3 while SCSI disks are either unit 0 or 
unit 1. 

Next diag displays a menu of the different disks for which it has built-in 
configuration information, and asks for the disk drive type. If you select one of 
these (except for other), diag prints some physical data about that disk, 
including the number of data cylinders, number of alternate cylinders, number of 
heads, and number of sectors per track. If you select other, it prompts for this 
information. It then initializes the controller, and for SMD controllers issues a 
status command to the device, then displays results. This works like the 
status command issued to the diag> prompt. 



The following example shows a Fujitsu M2312K (84-Mbyte unformatted) disk 
controlled by a Xylogics 450 controller with Revision C PROMs. 




If you have an older Xylogics board with Rev A PROMs, diag issues a warning 
message stating that these boards should be upgraded. They perform certain 
operations incorrectly, which causes the software to be unable to detect some 
ECC errors. 



Now diag has the information it needs about the disk. It returns to the com- 
mand mode and displays its prompt 




If the sequence fails before this point, check the hardware cabling and the infor- 
mation already given. Then use the diag command to reenter the data, or 
reboot diag. 



If you select the other drive type, diag asks for information about the drive. 
Once you have defined the new drive type, diag adds this entry to the list of 
drive types, enabling you to use it over and over. Diag allows you to define a 
total of 4 other drive types. 

NOTE Consult the disk drive manual for information about other disk drives. This 

manual should be supplied by the disk drive manufacturer, not by Sun. 
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The following two examples show how to configure an other disk drive for an 
SMD, then a SCSI controller. 

The first example shows questions asked when using a Xylogics 450 controller 
for an imaginary SMD disk called a “Bogus-M1234”. The second example 
shows the same for an imaginary SCSI ST506 disk called a “Phony-4321”. 

Suppose that the manufacturer’s manual says that the Bogus 1234 has 823 
cylinders, 10 heads, and 33 sectors/track, with 600 bytes/sector. For compatibil- 
ity with Sun supported disks, you must allocate at least two alternate cylinders. 
These are necessary to store the defect information on the disk. Also, to leave a 
spare sector per track for slip-sectoring, tell diag there is one less data sector 
per track than there really is. 

/ \ 

Specify drive: 

0 - Fujitsu-M2312K 

1 - Fujitsu-M2284/M2322 

2 - Fu jitsu-M2351 Eagle 

3 - Other 
which one? 3 

Note: # of data cylinders must be at least 2 less 
than the physical number of cylinders . 

# of data cylinders? 820 [total cyls minus alts] 

# of alternate cylinders (min 2)? 2 [for bad sec forwarding] 

# of bytes/sector (incl overhead)? 600 [for defect calculations] 
first head? (usually 0, 2 for Lark fixed) 0 

physical partition? (usually 0, 1 for Lark cartridge) 0 

# of heads? 10 

drive type? 3 [Xylogics only -0 to 3] 

ASCII identification? Bogus-M1234 [Used for labeling disk] 

[same as partition and] 

# of data sectors/track? 32 [one less for slipping] 

interleave factor? 1 

ncyl 820 acyl 3 nhead 10 nsect 32 interleave 1 
status : ready 
drive status : ready 
Xylogics PROM Rev 'C' 

S J 



NOTE On the Xylogics 450/451 controllers, all disks with the same drive type must be 
the same type of drive. This is straightforward in the above example; the Bogus- 
M1234 is assigned drive type 3. To add a second other different from the 
Bogus-M1234 you would have to assign it a different drive type. If you do this, 
be sure you do not assign it the drive type of a disk that is or will be connected to 
that controller. For more on drive type numbers, see the command rhdr . 

Diag asks different questions for a SCSI controller. The following example 
shows how to configure a Phony-4321 with 578 cylinders, 5 heads, and 17 sec- 
tors per track, for use with the Adaptec ACB 4000 controller. The drive manual 
recommends using a buffered seek of 2 and write precomp starting at cylinder 0. 
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NOTE The menu for an ESDI disk is slightly different. Because the Emulex controller 

requires 4 cylinders of each disk for internal use, the number of data cylinders 
must be at least 6 less than the physical numer of cylinders. Also, the questions 
concerning buffered seek and write precomp are not asked for ESDI disks, since 
they don't apply. 

6.11. Preparing a New Disk This section describes how to use diag to prepare new SCSI and SMD disks for 

operation. This discussion assumes that diag is loaded and configured as 
described earlier. 

This process includes formatting the disk, performing surface analysis, then writ- 
ing a label on the disk. Formatting divides the disk into blocks and sectors, sur- 
face analysis checks for and repairs surface defects, and labeling writes important 
information on the disk, including the disk name and the partition map. 

The partition table defines the disk partition boundaries that UNIX uses for file 
system boundaries. You should have ready the information you will need to 
build the partition table when you start this procedure. If you are going to use 
one of diag’s built-in partition tables, this is no problem, but if you are going to 
use any other partition table, see the instructions for the partition command 
later in this chapter. 

NOTE If you are installing a new system, we recommend that you use the instructions in 

Installing UNIX on the Sun Workstation to prepare your disks. 

diag provides 2 different format subsystems; one for SCSI disks and one for 
SMD disks. This section discusses each separately. 
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SCSI Disks The following procedure provides instructions for testing, formatting, and label- 

ing a SCSI disk. Use the following procedure to format and label a disk: 

1. Load and boot diag. 



2. Type format to access diag’s SCSI format subprogram (diag knows 
it’s dealing with a SCSI disk from information provided during 
configuration). It displays its prompt: 



— 


^ 


diag> format 




SCSI format. 




format> 






> 



2a. If a new disk is unformatted or the defect list has been corrupted, diag 
prints a message saying it was unable to read the defect list off the disk. If 
this happens, you must format the disk using the f subcommand: 



/ 




diag> format 




SCSI format. 




no defect list found 




format> f 




formatting. . . 




v 


J 



To see a list of all the SCSI format subcommands, type: 


format> ? 

SCSI Format Subcommands: 
f: format disk 
p: print defect lists 
a: add defect to physical list 
b: bias added defects 
c: clear defect lists 
d: delete defect from lists 
s: surface analysis 
r: reassign logical block 
t: translate logical block # to physical 
q: quit format 

s 



Before going on, it is worth understanding SCSI defect lists in detail. There are 
several types of defect lists, defined below. 

manufacturer’s defect list 

This is the list of defects supplied by the drive’s manufacturer. It is always 
supplied in hardcopy form with each drive. On ESDI disks, this list is also 
stored on the disk itself, so the controller can read it. These defects are 
always in physical format (see below). 

grown defect list 

This is die list of all defects added by the user because they were not on the 
manufacturer’s defect list These defects may be in physical or logical 
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format (see below). On ESDI disks, this list is also stored on the disk, so the 
controller can read it. The sum of the grown list and the manufacturer’s list 
always equals the total list of known defects. 

physical defect list 

This is the list of defects in physical format, including the manufacturer’s 
defect list, and grown defects entered by the add command. For ST506 
drives, this is the total list of known defects. Diag displays this list when 
given the print command. Diag keeps a copy of this list on the alternate 
cylinders. 

reassigned block list 

This is the list of defects in logical format. This list is nonzero only on 
ESDI disks. It contains grown defects entered by the reassign command. 
The sum of the reassigned list and the physical list equals the total list of 
known defects for ESDI drives. Diag displays this list when given the 
print command. Diag keeps a copy of this list on the alternate cylinders. 

Each time the SCSI format subcommand is entered, diag reads the physical 
and reassigned lists off the alternate cylinders into memory. If the reassign 
command is used to add a sector to the reassigned list (ESDI only), the list is 
immediately updated and the new copy written to disk. However, any other 
changes made to the lists in memory do not take effect unless you format the 
disk. Thus, if you change the defect list then leave the format subcommand 
without formatting the drive, those changes are lost forever. The reassign 
command is the only exception to this rule. 

If the defect lists on the alternate cylinders are destroyed for some reason, the 
necessary action depends on the type of drive. For ST506 disks, you will have to 
reenter all the defects using the add command, then reformat the drive. For 
ESDI disks, it is easier. Since the controller stores copies of the manufacturer’s 
and grown lists on the disk itself, diag simply asks the controller for these lists 
and then rebuilds the lists on the alternate cylinders. The only effect is that 
defects on the reassigned block list will appear on the physical defect list This is 
because the controller stores all defects in physical format In rare instances, the 
controller may be unable to find its lists, and the defects may have to be reentered 
by hand. 

3. Check to make sure that the disk defect list written on the disk matches the 
hardcopy list shipped with your drive. Enter the command p to display it on 
the screen: 

NOTE The location of the hardcopy list depends on the workstation type. It is usually 
taped to the front or top of the pedestal. If you don’t see it or have misplaced it 
during unpacking, look for a second copy taped to the disk drive housing inside 
the pedestal; to find it, consult the appropriate hardware manual. Be sure to 
replace this second copy when you have used it. Also note that on a some 
drives, the hardcopy list groups defects by head; the cylinder and bytes from 
index numbers appear in the CYL and BI columns. On others, the numbers 
appear in the CYL, H, and BYTE columns respectively. 



#sun 

v' microsystems 



Revison A of 10 October 1986 





System Administration Manual 1 35 



/ 






> 


format> 


P 






Defect 


list - Physical Format 






Defect 


Cylinder Head Bytes 


from Index 




N 


NN N 


NNNN 




etc . 








v 






J 



4. Make sure this either matches the hardcopy disk defect list. It may have 
more defects on it, but not fewer. 

a. If they match, continue with step 4. 



b. If the hardcopy list shows defects that are not displayed on the screen 
list, use the a command to add to the list in memory (it will get written 
on the disk when you format it): 



r 




format> a 




cylinder? number 




head? number 




bytes from index? number 




v 


J 



c. If you cannot read the list from the disk, use the a command as shown 
above to type in the entire hardcopy list. The only exception to this is 
with a brand new ESDI drive. Even though the defect list cannot be 
read off the disk, the controller can get at it Simply format the drive; 
the controller automatically uses the built-in defect list. After the for- 
mat, diag extracts the defect lists from the controller and stores them 
on the alternate cylinders. 

d. After making any changes to the list on the disk, use the p command to 
display the changes on the screen. Check again to make sure the copy 
on the screen matches the hardcopy list. 



5. When you have verified the defect listing, format the disk with the format 
(f ) command. After you type this command, the system displays a warning, 
then asks for confirmation: 



— 




format> format 




DISK FORMAT - DESTROYS ALL DISK DATA! 




are you sure? y 




Formatting. . . 




v 


J 



The formatting process takes three minutes or more. At the end, you should see a 
message: 

— 
done . 

V 



For ESDI drives, you may also see a message about reassigning grown defects; 
this is OK. If you see any other message (SCS I reset, for example), the 
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formatting process did not succeed, and the defect list was not recorded on the 
disk. You must format the disk again. 

6. When you have successfully formatted the disk, do a surface analysis using 
the (s) sub-command. This analyzes the entire disk surface, then displays a 
list of any defective sectors it found. For a new disk, you should ask for five 
surface analysis passes: 

. 

format> s 

# of surface analysis passes (5 is usual) ? 5 
v - 



Five passes may take an hour or more to complete. When it’s done, it displays a 
message to announce that fact 

7. For ESDI disks, diag automatically reassigns any defective sectors it finds. 
It also adds these sectors to the defect lists immediately, so there is no need 
to format the disk again. If all the defective sectors were successfully reas- 
signed, you can proceed with the next step. If one of the reassignments 
failed for any reason, you should reassign that sector by hand, then rerun the 
surface analysis to make sure the disk is clean. For ST506 disks, diag sim- 
ply reports the bad sectors it found and adds them to the defect list in 
memory. When it’s done, it tells you to re-format the disk: 



r 




Surface analysis complete 




some number bad sectors found 




Use the ' V command to format the disk. 




format> 









Before continuing, you must: 

a. Reformat the disk (go back to step 4). 

b. Continue this loop until the surface analysis reports that it found no bad 
sectors. Once the surface analysis completes without finding any bad 
sectors, the format is successful. 



8. Enter q to exit the format subsystem: 



r 


> 


format> q 




diag> 




V 


J 



A system may have more then one controller, and a controller may have more 
than one disk. The format process described above must be repeated for every 
controller and every disk. 

NOTE The following ’ label ’ operation writes a partition map on your disk. If you do 

not have a custom partition made, or you do not intend to use the default, you 
may continue, but note that you will change the partition map later. 

9. Type label to the diag prompt. 
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— 


\ 


diag> label 






J 



10. diag now asks if you want to use the built-in partition map, then asks for 
confirmation: 

diag> label 
label this disk. . . 

OK to use logical partition map ' your disk type ' ? y 
Are you sure you want to write? y 

V , 



1 1. After labeling the disk, diag automatically verifies the label it has just writ- 
ten. The following example shows the verily for a Micropolis 1325: 

' N 

[ This is an example only; do not enter this information. ] 
verify label 

id: <Micropolis 1325 cyl 1022 alt 2 hd 8 sec 17 interlv 1> 
Partition a: starting cyl=0, # blocks=15912 [ it’s vary ] 

Partition b: starting cyl=117, # blocks=33456 
Partition c: starting cyl=0, # blocks=138448 
Partition g: starting cyl=363, # blocks=89080 

diag> 

s / 



12. If you confirm, diag partitions your disk according to the default maps 
shown below, then exits. 

The following table shows the default partitions for Sun-supplied SCSI disks: 2 



Table 6-3 Default Partition Sizes for SCSI Disk Subsystems 



~ ^ Partition Sizes (MBytes) 

SCSI Disk Raw 

64 h. 55 


Micropolis 1304 


50 


8.1 


8.4 


43.1 


unused 


unused 


unused 


26.5 


unused 


Micropolis 1325 


85 


8.1 


17.1 


70.9 


unused 


unused 


unused 


45.6 


unused 


Maxtor XT- 1050 


50 


8.1 


8.4 


44.4 


unused 


unused 


unused 


27.9 


unused 


Fujitsu M2243AS 


86 


8.1 


17.1 


70.8 


unused 


unused 


unused 


45.6 


unused 


Vertex VI 85 


85 


8.1 


17.1 


70.9 


unused 


unused 


unused 


45.5 


unused 


Micropolis 1355 


170 


8.1 


17.1 


141.7 


unused 


unused 


unused 


116.5 


unused 


Toshiba MK156F 


170 


8.1 


17.1 


141.8 


unused 


unused 


unused 


116.6 


unused 



2 Note that the numbers in this table are approximate: formatted capacity depends on the type of controller. 
Also, note that a ‘Megabyte’ of disk capacity is defined as one million bytes, and that UNIX file storage 
capacity is substantially smaller. 
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SMD Disks 



This section provides instructions for formatting, checking, and labeling an SMD 
disk. It assumes that any slippings and mappings already on the disk should be 
left intact. If this is not the case, the s format command described at the end of 
the manual should be used. 

NOTE You must have a partition map ready before beginning this procedure. 



1 . Enter the command format : 



/ 




diag> format 




DISK FORMAT - DESTROYS ALL DISK 


DATA! 


are you sure? y 




Formatting 




NNN 




[messages about slippings and mappings ] 




Verifying 




NNN 




total defects N with N original 


defects from manufacturer 


diag> 




V 


J 



During the formatting and verifying phases, diag displays the number of each 
track it completes. Now continue to step 2. 

NOTE From here on, this procedure assumes you have are either going to use a default 
partition table or you have written or modified one using the partition com- 
mand. The default partitions are designed for standalone use only; if you are 
installing an NFS server, or have any other reason for not using the default par- 
tition, construct or modify a partition with the partition command, then 
return here. 



2. Enter the command label: 



r 

diag> label 


j 


Diag now asks if you want to use default partition map, then asks for 
confirmation before proceeding: 




r~ 

diag> label 
label this disk. . . 

OK to use logical partition map 'disk type' 1 y 
Are you sure you want to write? y 


’X 


V 


J 



NOTE diag remembers if you recently used the partition command; if so, it uses the 

last partition you accessed in place of ‘ disk type’ above. If you just created a 
custom partition called ‘xyz’ , it asks: 

OK to use logical partition map xyz? 
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3. After labeling the disk, diag automatically verifies the label it has just writ- 
ten. For example, the verify for a Fujitsu M2322 might look like this: 


[ This is an example only; do not enter this information. ] 
verify label 

id: <Fu jitsu-M2322 cyl 821 alt 2 hd 10 sec 32 interleave 1> 
Partition a: starting cyl=0, # blocks=15884 
Partition b: starting cyl=50, # blocks=33440 
Partition c: starting cyl=0, # blocks=262720 
Partition g: starting cyl=155, # blocks=213120 

diag> 

s 



The following table shows the default partitions: 3 
Table 6-4 Default Partition Sizes for SMD Disk Subsystems 



, _ Partition Sizes (MBytes) 

SMD Disk Raw 

44g>> 44^)) 44g)> 4 4J^>) 


Fujitsu 2312K (8") 


84 


8.1 


17.1 


67.3 


unused 


unused 


unused 


42.0 


unused 


Fujitsu 2284 (14") 


169 


8.1 


17.1 


134.5 


unused 


unused 


unused 


109.1 


unused 


Fujitsu 2322 (8") 


168 


8.1 


17.1 


134.5 


unused 


unused 


unused 


109.1 


unused 


Fujitsu 2351 Eagle 


474 


8.1 


17.1 


395.7 


unused 


unused 


unused 


369.8 


unused 


Fujitsu 2333 (8") 


337 


8.2 


17.2 


281.6 


unused 


unused 


unused 


256.3 


unused 


Fujitsu 2361 Eagle 


690 


8.2 


17.2 


576.3 


unused 


unused 


unused 


550.9 


unused 


CDC 9720 (8") 


347 


8.3 


17.2 


281.9 


unused 


unused 


unused 


256.3 


unused 



6.12. Troubleshooting With 
Diag 



This section shows methods for using diag to deal with disk problems. 

Usually, you find out you have disk problems when you see a UNIX error report. 
This should provide the file system name, and a disk block number in partition- 
relative and absolute form. For example: 

/ \ 

SdOg read error block xxx abs block nnn 

s 



To deal with this error, you must discover and repair the cause of the error and 
repair the surface of the disk. 

This section provides the following procedures: 

Fixing a Bad Sector (SCSI) — Describes how to use the information in a 
UNIX error report to add a sector to the bad sector list (SCSI only.) 



3 Note that the numbers in this table are approximate: formatted capacity depends on the type of controller. 
Also, note that a ‘Megabyte’ of disk capacity is defined as one million bytes. 
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Checking and Fixing a Bad Sector (SMD) — Describes how to go to the sec- 
tor indicated by a UNIX error report, determine correct action, and repair the 
defect This procedure provides a reasonable chance of salvaging most of 
the data on the defective sector. 

Electronic Problems — Describes how to set up diag to test the swapping 
area of the disk, so you can perform electronic troubleshooting while using 
diag to check the disk functionality without destroying critical data on the 
disk. 

Checking and Fixing a Bad Use these procedures to add a bad sector reported by UNIX to the bad sector list 

Sector (SCSI) on the disk. 

ST506 Controllers 1. Obtain the absolute block number {nnn) from the UNIX error message. 

2. Take full dumps of your entire system. 

NOTE Because of the nature of the ST506 interface, repairing any surface defect 

requires reformatting the disk, which erases all the data on it . To ensure the 
safety of your data, take a full dump before starting any ST506 disk repair. 

3. Boot and configure diag as described earlier in this chapter. 

4. Do a read of the area to obtain the exact address of the failed block. Start 
the read a few sectors before the one reported to be sure you cover the bad 
sector (NNN = nnn-20 in the example): 



diag> read 
starting block? NNN 

# of blocks? 40 
increment? 1 

# of blocks per transfer? 1 
NNN/NN/NN 

And if it fails... 

NNN/NN/NN Read failed, cyl =NNN f head = NN, 
sector = NN scb: N check 
[A few lines of other information] 



V 

5. Enter the format subsystem: 


j 


diag> format 
SCSI format. 
format> 


s 


v 


/ 


6. Use the translate command to obtain bytes from index: 


— 
format> t 

logical block number? NNN/NN/NN 
cyl NNN head NN bfi NNNN (physical) 




l 


J 
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7. Use the format subsystem add command to add this data to the list: 




8. Now format the disk: 




9. Restore the system from the dump tape made earlier. 

ESDI Controllers 1 . Obtain the absolute block number {nnn) from the UNIX error message. 

2. Boot and configure diag as described earlier in this chapter. 



3. Do a read of the area to obtain the exact address of the failed block. Start 
the read a few sectors before the one reported to be sure you cover the bad 
sector (NNN = nnn- 20 in the example): 




4. Enter the format subsystem: 




5. Use the subcommand reassign to mark the sector defective: 
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f > 

format> r 

logical block address? NNN 

logical block NNN (Ox HHH) reassigned 

format> 

s > 



Checking and Fixing a Bad 
Sector (SMD) 



To repair a bad sector on an SMD disk, use the following procedure: 

1 . Obtain the absolute block number (nnn) from the UNIX error message. 

2. Boot and configure diag as described earlier. 



NOTE It's a good idea to toggle the ‘ errors’ flag so you can see retrys. Sometimes it is 
the only way to spot the error. To toggle the flag, enter: 



r 


> 


diag> e. 




V 





3. Do a read of the area to obtain the exact address of the failed block. Start 
the read a few sectors before the sector reported, to be sure you cover the 
bad sector (NNN = nnn-20 in the example): 

> 

diag> read 
read 

Starting block? NNN 
number of blocks? 40 
Increment? 1 

# of blocks per transfer? 1 
CC/HH/SS diag> 

Or, if you have an error: 

Read failed #6, CRC/hard ECC error, cyl=«n head=nn sector=dd 

Note: above message is example only. If you have ‘errors' flag 
set for retrys, a similar message may appear several times. 
v ) 



4. If your disk is configured for slipping, attempt to slip the bad sector: 
— 

diag> slip 
slip sector 

slipping may be removed only by complete format of the disk 

cylinder number? NN 

track number? NNN 

logical sector to be slipped? NN 

Attempt to preserve data? y 

OK to attempt slip of logical sector CCIHH/SS? y 
diag> 

< 



5. If the slip does not succeed, the following buffer shuffle gives you a fairly 
good chance to save your data: 



♦ 



sun 

microsystems 



Revison A of 10 October 1986 









System Administration Manual 143 



a. Use the map command as if to map the defective sector. When it asks if 
you want to save the data, say yes: 



p 


\ 


Attempt to save data? y 




V 


) 



b. When it asks if you want to actually write in the mapping, say no: 



r 


a 


OK to map this sector? n 
< 


j 



c. Now do a write to the defective sector. Note that because diag still 
has the “saved” data in its buffers, it will restore the original data to the 
bad sector. 

CAUTION To avoid losing data, be sure to write to only the one sector that you used the 
map command on. 



p 

diag> write 
write 

starting block? NNN 

# of blocks? 1 
increment? 1 

# of blocks per transfer? 1 
CC/HH/SS diag> 




''j 

j 


6. Now repeat the read from above: 






diag> read 




read 




Starting block? NNN 




number of blocks? 40 




Increment? 1 




# of blocks per transfer? 1 




CC/HH /NN diag> 




v 


J 



Electronic Problems 



7. If the sector checks out OK, the problem is solved. You may want to repeat 
the read a few times to make sure the sector is not marginal. If the read 
still reports an error, repeat the map done earlier, only when it asks for per- 
mission to map the sector, answer yes. 



Many disk errors are caused by problems with the disk cables or the electronics. 
These problems tend to generate multiple disk error messages at random loca- 
tions. 

The following procedure shows how to set up diag to * ‘bang” on the swap area 
of the disk. This is where the most expendable data lives; destroying the data 
here should cause minimum harm. This procedure does not describe how to 
troubleshoot the electronics; it only describes how to set up diag so that the 
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electronics troubleshooting causes the least damage. 

For electronics troubleshooting instructions, see the appropriate field service 
manual. 



1 . Start up and configure diag for the disk with the problem. 



2. Enter the verify command. For a Micropolis 1304, the display goes: 



diag> v 
verify label 

Micropolis 1304 cyl = 824, alt 5, 
partition a: starting cyl # 0 
partition b: starting cyl # 156 
partition d: starting cyl # 0 
parititon g: starting cyl # 317 



hd 6, sec 17> 

# blocks 15884 

# blocks 16442 

# blocks 84150 

# blocks 51856 



On almost all disks, the swap space is partition b. To make diag do reads 
within partition b, request a read using a cylinder within partition b. For 
example, enter the following: 

CAUTION To avoid damaging data, make sure you really hit the swap space. Be sure 
a) you don’t leave the slash off the cylinder number, b) the starting cylinder 
is within partition b, and c) the number of blocks does not lead into the next 
partition (g in this example). 



diag> r [This is an example only] 

read 

starting block? 156 / [Don’ t forget the "/"!] 

# of blocks? 16442 [Or fewer blocks to be safe] 

increment ? 1 

# of blocks per transfer ? 1 
NNN/NN/NN 

< > 



NOTE In this example, diag will do reads of the entire swap space block by block. If 
you wish to make it read the same block over and over, use an increment ofO. 

6.13. Command List The following list shows the diag subsystems, commands, and subcommands. 

Note that subsystems provide access to subcommands, while commands initiate 
action from the top layer of diag. Subprograms are routines called by subsys- 
tems. 

For convenience, the commands are divided into several categories. These are: 

Toggle flags and options 
Miscellaneous commands 
Perform some test 

Do something complicated and interactive to the disk. 
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Toggle Flags and Options All the flags and option toggles work similarly; the option is either ON or OFF, 

and calling the following commands cause it to switch states and display its new 
value: 

error — When ON, displays messages for every retry; when OFF, 
displays a message only after all retries are done. (Most operations retry 3 
times; formatting retries 1 time), (default = OFF). 

info — When ON, provides verbose messages for every operation per- 
formed (default = OFF). 

time — When ON, displays timing messages for formatting, read, and 
write operations (default - OFF). 

s lipmsgs — When ON, provides before and after dumps of track headers 
when a sector is slipped (default = OFF). 

f ormatmsgs — When ON, if a corrected error occurs during disk format- 
ting, a message is displayed; when OFF, corrected formatting errors are not 
reported (default = OFF). 

mapcheck — When ON, if an error occurs during a read, write , 
position or test command with an SMD disk, it reads the map table 
from the disk, and checks to see if any sector in the range tested has been 
mapped. If so, it reports this fact. Since diag reports errors when trying to 
read a mapped sector, the mapcheck message may explain an otherwise mys- 
terious error report (default = ON). 

Miscellaneous Commands Use the following commands to help you use diag: 

help or ? — Display current list of commands available, 
quit — Exit diag. 
clear — Clear drive faults. 

status — Fetch and display current controller and drive status. 

diag — Reset configuration information (described earlier in this manual). 

translate — Take a disk address and display it in CC/HH/SS, decimal, 
and hex, translated for the currently configured disk. 

addition and subtraction — Entering a + or - on the command line causes a 
prompt asking you for two numbers (to be added or subtracted). Diag pro- 
vides the result in decimal, hex, and cylinder/head/sector form, translated for 
the currently configured disk. 

version — Displays all the secs identifiers in the program. 

verify — Reads the labels on the disk, prints out the partition map, and if 
necessary, asks if you want to restore die primary label. 
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Tests 



Complicated, Interactive 
Commands 



The following commands perform non-interactive tests: 

position — This non-destructive test checks the ability to seek and read 
sectors. It selects and reads single sectors at random, continuing until the 
user types A C. If it encounters an error, if map check is on, it checks to see 
if the sector is mapped; if so, it reports that fact. 

test — This destructive test writes, then reads groups of sectors continu- 
ously, testing for ability to seek, write, and read. It selects sectors at ran- 
dom, and tests a block of sectors starting there. It prompts for the size of the 
block, and it continues until the user enters A C. If it finds an error, and if 
mapcheck is ON, it checks the map to see if any sectors in the group are 
mapped. If so, it reports that fact. 

seek — This non-destructive test can do an hourglass seek over all 
cylinders, then report the time it took. It can also continuously seek between 
two given blocks. 

read/ write — This test checks for ability to read and write data. Write 
is destructive but read is not 

dmatest (Xy logics 450/451 controller only) — This test checks the Xy lo- 
gics controllers using BUFLOAD and BUFDUMP commands. If 
abort dma is ON, it exits when it finds an error; otherwise it continues until 
the user types A C. 

The following commands provide significant interaction with the disk. They are 
described in detail, later. 

map (SMD disks only). This command enables you to read the current list 
of mapped sectors, and to (optionally) add a new sector to that list. 

fix (SMD disks only). This command reformats and verifies a given range 
of the disk. 

slip (Xylogics 450/451 only). This command allows you to manually slip 
individual sectors on a Xylogics-controlled disk with slip-sectoring enabled. 
It prompts to see if you want to attempt to save the data in the sector being 
slipped. 

rhdr (read headers — Xylogics 450/451 only). This is among the most 
informative commands; it displays individual sector headers sequentially. 
Use it to help identify slipped or mapped sectors, to show whether the disk is 
configured for sector slipping, and to help spot anomalies in sector headers. 

label (write label on disk) — This command writes a label on the disk. 

partition (set partition table) — This command allows you to set the 
partition table boundaries. 

scan — This destructive command does repeated sector scans over a 
specified range of the disk. On SMD disks, it can automatically map or slip 
any bad sectors it finds. Use this command after formatting the disk, but 
before installing UNIX, to check for bad sectors that didn’t show up on other 
tests. 
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format Command 



map Command 



whdr (Xylogics 450/45 1 only) — This command reads in existing sector 
headers starting at a specified location, then loops while asking if you want 
to change a header. SPECIAL USES ONLY. 

format — diag actually provides a SCSI format subsystem with its own 
format subcommand, and an SMD subsystem with its own format sub- 
command. Format subsystems are where you go to perform formatting 
related operations, and the format subcommands actually cause the format to 
occur. 

s format — For SMD only. A special formatting subprogram for manipu- 
lating the defect list on SMD disks. It allows you to enter the 
manufacturer’s defect list manually, if the list has been corrupted. It also 
allows you to format the disk using only the original manufacturer’s defects. 
This is useful if sectors were errantly slipped or mapped, and you wish to 
restore them to normal. 

Formatting a disk describes the process of dividing it into sectors so UNIX can 
use it. diag provides separate format subsystems for both SMD and SCSI 
disks; these are invoked by entering the command format to the diag prompt, 
diag selects the proper subsystem based on configuration information. 



Once within either format subsystem, the prompt changes to: 



/ 


> 


format> 




v 


J 



Both format subsystems provide format commands; these actually perform the 
format operation to the disk. For instructions to use the format commands, see 
the earlier part of this chapter. 

The map command (SMD disks only) displays the current map table and allows 
you to add a new mapping. 

CAUTION This command destroys disk data if you add a new mapping. Backup disk 
data before proceeding. 

After you enter map, it displays the current map table, then prompts for addi- 
tional information. When it asks if you want to add a mapping, if you enter n, it 
exits without changing anything. If you enter y to add a mapping, it asks if you 
want to attempt to preserve the data. If you answer y, it writes the data to the 
alternate sector before the mapping is actually done. A typical session goes: 



♦ 
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^ 

diag> map 

Current mapping: 

Sector CC/HH/SS mapped to CC/HH/SS 
Sector CC/HHISS mapped to CCIHH/SS 
Do you wish to add a mapping? y 

mapping may be removed only by complete format of the disk 

cylinder to be mapped? 704 

track to be mapped? 9 

sector to be mapped? 7 

Attempt to preserve data? y 

Data transfer successful! 

OK to map 704/9/7? y 
mapped sector 704/7/7 to 822/8/31 
V > 



After it maps the sector, map adds the new sector to the map, marks the old sec- 
tor bad, and rewrites the new map table. 

If a read error occurs during attempt to preserve data, map reports the transfer 
unsuccessful. This may be only partially true; with fixed ECC errors, the data is 
still intact. With a hard CRC error, some data may survive, but with other errors 
the data is usually lost 

You can map a sector on a disk set up for slip sectoring, but slipping a bad sector 
is preferable to mapping it. 

f ix Command The fix command formats and verifies user-specified sections of SMD disks. 

Use it to verify a section of the disk without doing the entire thing. 

CAUTION This command destroys disk data. Backup disk data before proceeding. 

Fix requires a starting and ending track address. It also requires a number of 
surface analysis passes. After it obtains this information, it asks for permission 
to continue. 



A typical session might go: 



diag> fix 

fix — DESTROYS SOME DISK DATA 




Warning! use 'format' command when fixing the 

formats a range of tracks 

enter track number as 'cyl/track' 

starting track? 15/20 

ending track? 15/30 


whole disk. 


# of surface analysis passes (5 recommended) ? 
OK to format from 15/20/0 to 15/29/31? y 

cam 

diag> 


5 


V 


J 



CC/HH represents the current track number. It increments as the test 
proceeds. 
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slip Command 



rhdr Command 



If you answer y, it proceeds like a format within the specified boundaries, except 
that it prints cylinder/head numbers instead of just cylinder numbers. If it 
encounters a previously slipped sector, it reslips the sector after the track is for- 
matted, and displays a message announcing this fact. It reports mapped sectors 
and adds them to the map if they are not already there. 

Before it exits, it writes the new bad sector table on the disk then updates the 
mapped sector headings. If it is interrupted, it does not write the new map or 
update the mapped sector headers. 

The slip command allows you to manually slip a sector on an SMD disk con- 
nected to a Xylogics controller, provided the disk and the sector are eligible for 
sector slipping. 

CAUTION This command destroys disk data. Backup disk data before proceeding. 

slip asks if you want to save data; if you answer y, it stores the data from the 
entire track in a buffer, and attempts to rewrite the data after the slip. The data 
usually survives ECC errors; other errors may cause damage. 

The command rhdr (read headers) works with Xylogics controllers only. It 
displays the sector headers for consecutive tracks. 

A display similar to the following results: 

diag> rhdr 

read track header 

starting track (dd/dd) : 00 

0/0 



sec 


0 


8000 


8100 


8200 


8300 


8400 


8500 


8600 


8700 


sec 


8 


8800 


8900 


8AOO 


8B00 


8C00 


8D00 


8E00 


8F00 


sec 


16 


9000 


9100 


9200 


9300 


9400 


9500 


9600 


9700 


sec 


24 


9800 


9900 


9A00 


9B00 


9C00 


9D00 


9E00 


9F00 


stop? ■ 


<ret> 
















0/1 




















sec 


0 


9F01 


8001 


8101 


8201 


8301 


8401 


8501 


8601 


sec 


8 


8701 


8801 


8901 


8A01 


8B01 


8C01 


8D01 


8E01 


sec 


16 


8F01 


9001 


9101 


9201 


9301 


9401 


9501 


9601 


sec 


24 


9700 


9801 


9901 


9A01 


9B01 


9C01 


9D01 


9E01 



stop? y 

s 



Reading headers can help locate anomalies in sector headers, and locate spare, 
mapped, slipped and mnt sectors. This in turn can help identify a disk with slip 
sectoring. The following headers identify unusual sectors: 

FFFFFFFF — Mapped sector. These headings identify mapped sectors. 
UNIX redirects accesses to these sectors to spare sectors as specified by the 
map. On a disk with slip sectoring, mapping occurs only after a second sec- 
tor on a track goes bad (very rarely). 

FEFEFEFE — Slipped sector. This header marks a place where a logical 
sector was slipped from. 
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DDDDDDDD — Spare data sector. Each track on a slip sectored disk starts 
life with a spare data sector; if a bad sector on that track is slipped, this spare 
gets used up. 

EEEEEEEE — Runt sector. This is the designation given to the extra space 
at the end of a track; it is usually too short for a data sector but too long to 
ignore. 

Use rhdr to help identify mapped or slipped sectors, or to discover if a disk is 
setup for slip sectoring. Also, if any error message identifies a track or sector as 
the source of a problem, use rhdr to check the headers in that area for con- 
sistency. 

Understanding a normal header number requires translating it from hex to binary 
and reading the contents of the fields. The bits are: 

ssOO Occc cccc cccc ttss ssss hhhh hhhh 

where: 

h = head number 

s = sector number (note s bits in two locations!) 
t - drive type 
c = cylinder number 
0 = unused bits, always set to 0 

The head number is straightforward; it is two hex numbers. 

The sector number is divided into two fields. 

The drive type is an identifier for the Xylogics controller. These are 
hardwired into diag except in case of other disk types. The usual assign- 
ments for these bits are: 

00 Fujitsu-M235 1 Eagle 

01 Fujitsu-M2312K and CDC EMD 9720 

10 Fujitsu-M2284/2322 

11 Fujitsu-M2361 Eagle and Fujitsu-M2333 



The cylinder number is also straightforward; three hex numbers where the 
most significant hex digit is <8 because its high-order bit is 0. 

When diag displays numbers, it strips off leading 0s. In the above header 
display, the first header with all zeroes attached would be 00008000. 

The following example shows the decoding of the last header number shown in 
the rhdr display above: 

9E01 - as shown 

00009E01 - append leading zeroes 

0000 0000 0000 0000 1001 1110 0000 0001 -translate to bir 
ssOO Occc cccc cccc ttss ssss hhhh hhhh - show field vali 
This shows it is cylinder 0, head 1, sector OxlE, on a drive type 2 (10 binary - 
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label Command 



partition Command 



Fujitsu-M2284/2322). 

The label command writes a new label on the disk. It asks if you want to use 
the ‘built in’ (default) partition map for your disk, and displays a copy of what it 
has done. 

NOTE If you write an incorrect label on a disk, UNIX may not be able to use a filesys- 
tem. However, if you rewrite a correct label it should correct the problem. 

A typical session goes: 



diag> label 
label this disk 

OK to use logical partition map disk typel y 
Are you sure you want to write? y 

S > 



After it writes the label, it displays the label it has just written. For example, if 

you had a Fujitsu M2322, it would display: 

— 

verify label 

id: <fujitsu-M2322 cyl 821 alt 2 hd 10 sec 32 interleave 1> 
Partition a: starting cyl=0, # blocks=15884 
Partition b: starting cyl=50, # blocks=33440 
Partition c: starting cyl=0, # blocks=2 62720 
Partition g: starting cyl=155, # blocks=213120 
diag> 

k > 



Note that the numbers in the above display differ depending on disk type. 

To use a label other than the ‘built in’ defaults, see partition , and Installing UNIX 
on the Sun Workstation. 



The partition command selects a table to use when labeling the disk. Diag 
maintains default partition tables for all standard disks; it asks you to select a 
disk, then prints the default partition table. Then it asks you if you want to 
modify this table. A typical session goes: 



diag> partition 
Select partition table 

0 - 'Fu jitsu— M2312K 

1 - Fu jitsu-M2312K Old Type 

2 - Fu jitsu-M2284/2322 

3 - Fu jit su-M22 8 4/2322 Old Type 

4 - Fu jitsu-M2351 Eagle 

5 - Fujitsu-M2351 Eagle Old Type 

6 - Fujitsu-M2333 

7 - Fujitsu-M2361 Eagle 

8 - CDC EMD 9720 

9 - Other 
Which One? 3 

Do you wish to modify this table? y 
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Partition a: starting cyl=0, # blocks=15884 
Change this partition? n 

Partition b: starting cyl=50, # blocks=33440 
Change this partition? n 

Partition c: starting cyl=0, # blocks=262720 

Change this partition? n 

Partition d: starting cyl=0, # blocks=0 

Change this partition? n 

Partition e: starting cyl=0, # blocks=0 

Change this partition? n 

Partition f: starting cyl=0, # blocks=0 

Change this partition? n 

Partition g: starting cyl=155, # blocks=213120 
Change this partition? y 
starting cylinder? 155 

# of blocks? 600/0/0 

Partition h: starting cyl=0, # blocks=0 
Change this partition? y 
starting cylinder? 755 

# of blocks 66/0/0 

Verify partition table ' Fu jitsu-M2284/2322' : 

Partition a: starting cyl=0, # blocks=15884 
Partition b: starting cyl=50, # blocks=33440 
Partition c: starting cyl=0, # blocks=262720 
Partition d: starting cyl=0, # blocks=0 
Partition e: starting cyl=0, # blocks=0 
Partition f: starting cyl=0, # blocks=0 
Partition g: starting cyl=155, # blocks=192000 
Partition h: starting cy 1=755, # blocks=21120 
OK to use this partition table? y 

Use the label command to write out the partition table. 

V 



scan Command 



CAUTION 



NOTE 



Note that if you select ‘other’, it asks you to name the partition table, and then it 
goes through the above sequence, except that all values start at 0. 

The scan command performs repeated sector scans over a specified range of the 
disk. It is typically used to find additional disk errors after the disk is formatted 
but before UNIX is installed. 

This command destroys disk data. Backup disk data before proceeding. 

scan looks for new bad sectors and doesn’t look at mapped sectors. Unlike 
fix, when it does a mapping, it writes the new mapping table to the disk 
immediately. It runs continuously until interrupted. 

scan includes a number of options, all of which it prompts for. These are: 

scan entire disk? — If you answer y, it scans the entire disk; if you answer 
n, it asks for beginning and ending addresses. If the area to scan includes 
primary and secondary label areas, it displays a message to this effect. 

If you overwrite the disk label, you will have to re-label the disk before use . 
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use random bit patterns? — y causes it to use random patterns (better for a 
small intensive disk scans); n causes it to use 5 standard patterns. 

perform corrections when defects are found? — If diag is configured for a 
Xylogics controller, scan asks if it should do corrections to bad sectors. If 
y, it tries to slip bad sectors and if it can’t, it tries to map them. If n, it only 
reports newly found bad sectors. If the controller is not a Xylogics, it 
displays a message that it cannot fix defective sectors. 

Using scan without fixing bad sectors is handy for tracking cable problems, or 
for other cases where you don’t want to fix a sector every time you find an error. 
It is also useful for SCSI surface analysis. 

A typical session might go: 

v 

diag> scan 

scan - continuous scan for defective sectors 

DESTROYS DISK DATA 

scan entire disk? n 

starting block? 700 

ending block? 702 

use random bit patterns? y 

perform corrections when errors are found? y 
OK to scan from 2/1/25 to 2/1/26? y 
type control-C to quit 

[pass 1 - bit pattern #1: Oxnnnnnnnn ] 

2/1/n 

\ 



Scan continues until the user aborts with control C. Then it prints: 



/ 


\ 


Command aborted 




diag> 






J 



whdr Command The whdr command (Xylogics 450/451 only) changes sector headers on request. 

This requires intimate knowledge of sector headers and should only be necessary 
under extreme circumstances. 

CAUTION This command destroys disk data. Backup disk data before proceeding. 

s format Command The s format command is a special purpose formatting subprogram for SMD 

disks. It should only be used when the disk’s defect list has been destroyed or 
contains incorrect information. 

CAUTION This command destroys disk data. Back-up disk data before proceeding. 

When you enter the s format subprogram, you can choose from the following 
commands: 
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/ \ 

diag> sformat 
specify format: 

1 - list defect list saved on disk 

2 - format only with original disk defects 

3 - manual entry for defect list 

4 - delete manual defect entry 

5 - change manual defect entry 

6 - exit sformat 
which one? 

V y 



list defect list saved on disk 

This command reads the defect list off the disk and displays it. The disk 
must be formatted for this command to succeed. 

format only with original disk defects 

This command is similar to the normal format command, except that it 
erases any defects that were added by slip and map. This command is 
useful only if you have errantly slipped or mapped sectors and wish to 
restore them to normal. 

manual entry for defect list 

This command allows you to enter the manufacturer’s defect list manually 
from the lard-copy supplied with every disk. Any existing defect list is 
overwritten by the one entered. After the list has been entered, the disk must 
be formatted with the normal format command before the changes are 
used. 

delete manual defect entry 

This command can be used to remove a defect that was incorrectly entered 
by hand. After deleting the defect, the disk must be formatted with the nor- 
mal format command before the changes are used. 

change manual defect entry 

This command can be used to change a defect that was incorrectly entered 
by hand. After the defect has been changed, the disk must be formatted with 
the normal format command before the changes are used. 
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The following pages are Errata and Addenda for Sun Release 3.0 version of the 
Assembly Language Reference Manual — Sun Part Number: 800-1372. 



Preface — Errata 



Introduction — Errata 



Assembler Directives — 
Errata 



Instructions and Addressing 
Modes — Errata 



Replace the first sentence of paragraph three of the preface with the following 

sentence: 

This manual describes the syntax and usage of the as assembler for the 
Motorola MC68010 and MC68020 microprocessors, the MC6888 1 floating- 
point coprocessor, and Sun’s Floating-Point Accelerator (FPA). 

Page 3 

Replace the heading before paragraph five, " -m6 8 0 1 0 or -10", with " - 
mc68010". 

Page 3 

Replace the heading before paragraph four, " -m6 8020 or -20", with " - 
mc68020". 

Page 37 

Append die following text to the end of the second paragraph: "stabn build 
various types of symbol table entries." 

Page 42 

Replace the definition of the d notation with the following: 

d refers to a displacement, which is a constant expression in as. In 68020 
mode, a length specifier ( : L, described below) may be appended to the dis- 
placement. Any forward or external references require the length specifier 
to be : 1. All other references permit either : 1 or : w. 

L refers to the index register’s length. This may be either long |i|iir word 
(w). If the only value permitted by a particular addressing mode or 
category is 1 or w, then L will be replaced by the appropriate value in 
the table notation. 
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s refers to a scale factor that may be used to multiply the index register’s 
length. The scale factor may have a value of 1, 2, 4, or 8. 

The table notation of two or three items separated by colons, such as ri : L : s, 
indicate items that may be optional. In that particular case, you may not specify 
: s unless you have specified : L, which you may not specify unless you have 
specified ri. The items in the list must appear in the order given in the notation 
of the tables that follow. 
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Page 43 

Replace Table 6-1 with the following table: 



Table 6-5 Addressing Modes 



Mode 


Notation 


Example 


Register 


an, dn, sp, pc, cc, sr, usp 


movw a 3 , d2 


Register Deferred 


an@ 


movw a38,d2 


Register List 


ri-ry or ri/rj 


movem a0-a4, a60- 


FPA register 


fpa i 


fpmoves fpal,d2 


Floating-Point Register 


fpi 


fmoves fpl,a30(24) 


(MC68881 only) 






Postincrement 


an@+ 


movw a30+, d2 


Predecrement 


an@- 


movw a30-,d2 


Displacement 


an@ (d) 


movw a38 (24),d2 


Word Index 


an@ (d, ri : w) 


movw a30(16, d2:w),d3 


Long Index 


an@ (d, ri:l) 


movw a30(16, d2:l),d3 


Absolute Short 


xcc:w 


movw 14:w,d2 


Absolute Long 


xxxil 


movw 1 4 : 1 , d2 


PC Displacement 


pc@ (d) 


movw pc© (20) ,d3 


PC Word Index 


pc@ (d, ri:w) 


movw pc0(14, d2:w),d3 


PC Long Index 


pc@ (d , ri : 1 ) 


movw pc8(14, d2:l),d3 


PC-Memory Indirect 


pc@ (d:L, ri:L: s) @ (d:L) 


movl pc0 (2 :w, d4 :w: 4) 0 (14 :1) , d3 


Pre-Indexed (68020) 






PC-Memory Indirect 


pc0 (d:L) @ (d:L, ri:L: s) 


movl pc0 (d:l) 8 (3:w,d2:l: 4) ,d3 


Post-Indexed (68020) 






Memory Indirect 


an@ ( d ' : L, ri : L: s) 8 (d: L) 


movl al0 (d:l,d2:l:4) 0 (14:w) 


Pre-Indexed (68020) 






Memory Indirect 


an8 (4:L)8 (d' :L, r»:L:s) 


movl a20 (2 :w) 0 (14 : w, d4 :w: 2) 


Post-Indexed (68020) 






Normal 


identifier 


movw widget , d3 


Immediate 


%xxx 


movw #27+3, d3 
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Page 45 

Replace Table 6-2 with the following: 



Table 6-6 Addressing Categories 



Addressing 

Mode 


Assembler 

Syntax 


Data 


Memory 


Control 


Alterable 


68020 

Only 


Register Direct 


a n, d n, sp, pc, 
cc, sr, usp 


X 






X 




A Register Indirect 


a «0 


X 


X 


X 


X 




A Register Indirect 
with Displacement 


a n@ (d:L) 


X 


X 


X 


X 


X 


A Register Indirect 
with Word Index 


a«0(d:L, rt : w : s ) 


X 


X 


X 


X 


X 


A Register Indirect 
with Long Index 


a«0(d:L, rt:l:s) 


X 


X 


X 


X 


X 


A Register Indirect 
with Post Increment 


an@ + 


X 


X 




X 




A Register Indirect 
with Pre Decrement 


a n0~ 


X 


X 




X 




A Register Indirect 
with Displacement 


an0 (d) 


X 


X 


X 


X 




A Register Indirect 
with Word Index 


a «0 (d, ri:w) 


X 


X 


X 


X 




A Register Indirect 
with Long Index 


an© ( d , ri :1) 


X 


X 


X 


X 




Memory Indirect 
Post-Indexed 


a n0 ( d:L)@( d:L,ri:L:s) 


X 


X 


X 


X 


X 


Memory Indirect 
Pre-Indexed 


a n0 (d r :L, ri:L: s) 0 (d:L) 


X 


X 


X 


X 


X 


Absolute Short 


xxx : w 


X 


X 


X 


X 




Absolute Long 


xxx : 1 


X 


X 


X 


X 




PC-relative 


pc0 ( d ) 


X 


X 


X 






PC-Indirect 
with Displacement 


pc0 (d: L) 


X 


X 


X 




X 


PC-relative with 
Word Index 


pc0 ( d, rz':w) 


X 


X 


X 






PC-Indirect with 


pc0 r*:w:s) 


X 


X 


X 




X 
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Table 6-6 Addressing Categories — Continued 



Addressing 

Mode 


Assembler 

Syntax 


Data 


Memory 


Control 


Alterable 


68020 

Only 


Word Index 














PC-relative 
with Long Index 


pc0 ( d , ri:l) 


X 


X 


X 






PC-Indirect with 
Long Index 


pc@ (d:L,rz:l:s) 


X 


X 


X 




X 


PC-Memory Indirect 
Post-Indexed 


pcG (d:L) @ (d' :L, r/:L:s) 


X 


X 


X 


X 


X 


PC-Memory Indirect 
Pre-Indexed 


pc6 (d' :L, rz:L:s) @ (d:L) 


X 


X 


X 


X 


X 


Immediate Data 


%nnn 


X 


X 









The current version of as doesn’t support base suppression. 



Error Codes — Errata 
Page 52 

Insert the following before the description of the Stab storage exceeded error message. 

Register out of range 

In the FPA’s dot product, matrix move and transpose instructions when the register specified does not fall within 
the specified range, then Register out of range error is reported. Note that for most instructions where one 
operand is an effective address, then register range is 0 to 15. If all operands are FPA registers, then register 
range is 0 to 31. For constant RAM registers, the range is 0 to 51 1. This type of error would probably also cause 
the Invalid operand error to be reported. 

Page 53 

Insert the following after the description of the Undefined symbol error message. 

Unqualified forward reference 

The displacement field in a 68020 based/indexed address mode contains an unqualified forward reference. Note 
that the displacement in a based/indexed address mode for 68020 instruction set can contain forward or external 
reference ONLY if the length specifier is present. The length specifier should be : 1 (long). This type of error 
would probably also cause Multiply defined symbol (Phase error). 

List of as Opcodes — Errata 
Page 57 

Replace the first paragraph with the following paragraph: 

This appendix is a list of the instruction mnemonics accepted by as, grouped alphabetically. The list is divided 
into two tables, the first covers the MC680x0 processor’s instuctions, the second covers the MC6888 1 floating- 
point processor’s instructions. (For more information about floating-point programming, see Floating-Point 
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Programmer' s Guide for the Sun Workstation.) 

Page 57 

Replace the bulleted paragraph beginning "An instruction of the form..." with the following: 

□ An instruction of the form addX in the assembly language syntax column means that die instruction is coded as 
addb, addw, or addl, etc. 

Pages 58-72 

Replace Table B-l with the following table: 



Table 6-7 List ofMC680x0 Instruction Codes 



Mnemonic 


Operation Name 




Syntax 


Processor 


abed 


add decimal with extend 


abed 


dy,dx 








abed 


a y@-, aX@- 




addb 


add binary 


addX 


ea, d/i 




addw 




addX 


dn,ea 




addl 




addX 


ea, an (except addb) 








addX 


%data, ea 




addqb 


add quick 


addqX 


%dala, ea 




addqw 










addql 










addxb 


add extended 


addxX 


d y, dX 




addxw 




addxX 


ay@~, aX@- 




addxl 










andb 


logical and 


andX 


ea, dn 




andw 




andX 


d n, ea 




andl 




andX 


§data, dn 




aslb 


arithmetic shift left 


a slX 


dX, dy 




aslw 




aslX 


idata, dy 




asll 




a slX 


ea 




asrb 


arithmetic shift right 


asrX 


dX, dy 




asrw 




asrX 


%data, dy 




asrl 




asrX 


ea 




bcc 


branch conditionally 


bccX 


label 




bccl 








68020 


bees 










bchg 


test a bit and change 


bchg 


dn, ea 








bchg 


%data, ea 




bclr 


test a bit and clear 


bclr 


dn, ea 








bclr 


%data,ea 




bkpt 


breakpoint 


bkpt 


idata 


68020 


bset 


test a bit and set 


bset 


dn, ea 
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Table 6-7 List ofMC680xQ Instruction Codes — Continued 



Mnemonic 


Operation Name 




Syntax 


Processor 






bset 


tfdata, ea 




btst 


test a bit 


btst 

btst 


dn, ea 
tfdata, ea 




bfchg 


test a bit field and change 


bfchg 


ea{ offset .width} 


68020 


bfclr 


test a bit field and clear 


bfclr 


ea{ off set. -width} 


68020 


bfexts ; 


extract a bit field signed 


bf ext s ea{ offset. -width} , dn 


68020 


bfextu 


extract a bit field unsigned 


bfextu ea{ offset. -width } , d n 


68020 


bff fo 


find first one in bit field 


bfffo 


ea{ offset. -width} , dn 


68020 


bfins 


insert a bit field 


bfins 


dn, ea{offset.-width } 


68020 


bf set 


test a bit field and set 


bf set 


ea{ offset. -width} 


68020 


bftst 


test a bit field 


bftst 


ea{ offset. -width} 


68020 


bcs 

bcsl 

boss 


branch carry set 


bcsX 


ea 


68020 


beq 

beql 

beqs 


branch on equal 


beqX 


ea 


68020 


bge 

bgel 

bges 


branch greater or equal 


bgeX 


ea 


68020 


bgt 

bgtl 

bgts 


branch greater than 


bgtX 


ea 


68020 




branch higher 


bhiX 


ea 


68020 




branch less than or equal 


bleX 


ea 


68020 


bis 

blsl 


branch lower or same 


blsX 


ea 


68020 


■ 

Egf9HH| 


branch less than 


bltX 


ea 




bmi 

bmil 

bmis 


branch minus 


bmiX 


ea 
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Table 6-7 List ofMC680x0 Instruction Codes — Continued 



Mnemonic 


Operation Name 


Syntax 


Processor 




branch not equal 


bneX ea 










68020 










bpl 


branch positive 


bplX ea 




bpll 






68020 


bpls 








bra 


branch always 


braX label 




bral 






68020 


bras 








bsr 


subroutine branch 


bsrX label 




bsrl 






68020 


bsrs 










branch overflow clear 


bvcX ea 










68020 










mmm 


branch overflow set 


bvsX ea 




ESllB 




bvsl 


68020 


B9H 








callm 


call module 


callm %data, ea 


68020 


cas2b 


compare & swap with operand 


cas2X del : dc2 , dal : d«2 , (rnl) : (m2) 


68020 


cas21 






68020 


cas2w 






68020 


casb 


compare & swap with operand 


casX dc,d«, ea 


68020 


casl 






68020 


casw 






68020 


chkb 


check register against bounds 


chkX ea,6n 


68020 


chkw 






68020 


chkl 






68020 


chk2b 


check register against bounds 


chk2X ea, rn 


68020 


chk21 






68020 


chk2w 






68020 


clrb 


clear an operand 


clrX ea 




clrw 








clrl 










compare register against bounds 


cmp2x ea rn 


68020 


m 






68020 








68020 


cmpmb 


compare memory 


cmpmX ay@+,aX0+ 




cmpmw 
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Table 6-7 List of MC680x0 Instruction Codes — Continued 



Mnemonic 


Operation Name 


Syntax 


Processor 


cmpml 










arithmetic compare 


cmpX' ea, d n 








cmpX %data,ea 




H 








dbcc 


decrement & branch on carry clear 


dbcc dn, label 




dbcs 


" on carry set 


dbcs d n, label 




dbeq 


" on equal 


dbeq dn, label 




dbf 


" on false 


dbf dn, label 




dbge 


" on greater than or equal 


dbge dn, label 




dbgt 


" on greater than 


dbgt dn, label 




dbhi 


" on high 


dbhi dn, label 




dble 


" on less than or equal 


dble dn, label 




dbls 


" on low or same 


dbls dn, label 




dblt 


" on less than 


dblt dn, label 




dbmi 


" on minus 


dbmi dn, label 




dbne 


" on not equal 


dbne dn, label 




dbpl 


" on plus 


dbpl dn, label 




dbra 


" always (same as dbf) 


dbra dn, label 




dbt 


" on True 


dbt dn, label 




dbvc 


" on overflow clear 


dbvc dn, label 




dbvs 


" on overflow set 


dbvs dn, label 




divs 


signed divide 


divs ea,dn 




divsl 




divsX ea, dn 


68020 


divsll 




divsX ea,dq 


68020 






divsX ea,dr:dq 


68020 


divu 


unsigned divide 


divu ea, dn 




divul 




divuX ea, dn 


68020 


divuw 




divuX ea, dn 


68020 






divuX ea, d q 


68020 






divuX ea, dr :dq 


68020 


divul 1 




divull ea,dr:dq 


68020 


eorb 


logical exclusive or 


eorX dn, ea 




eorw 




eorX %data, ea 




eorl 




eorb #data, cc 








eorw %data, sr 




exg 


exchange registers 


exg rx, r y 




extbl 


sign extend 


extbl dn 


68020 


extw 




extX dn 




extl 








jmp 


jump 


jmp ea 




jsr 


jump to subroutine 


jsr ea 




jcc 


jump carry clear 


jcc ea 
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Table 6-7 List ofMC680x0 Instruction Codes — Continued 



Mnemonic 


Operation Name 


Syntax 


Processor 


jcs 


jump on carry 


jcs ea 




jeq 


jump on equal 


jeq ea 




jge 


jump greater or equal 


jge ea 




jgt 


jump greater than 


jgt ea 




jhi 


jump higher 


jhi ea 




jle 


jump less than or equal 


jle ea 




jls 


jump lower or same 


jls ea 




jit 


jump less than 


jit ea 




jmi 


jump minus 


jmi ea 




jne 


jump not equal 


jne ea 




jpl 


jump positive 


jpl ea 




jra 


jump always 


jra ea 




jbsr 


jump to subroutine 


jbsr ea 




jvc 


jump no overflow 


jvc ea 




jvs 


jump on overflow 


jvs ea 




lea 


load effective address 


lea ea, an 




link 


link and allocate 


link an, Hfdisp 




linkl 




linkl an, %disp 


68020 


lslb 


logical shift left 


lslX dx, dy 




lslw 




lslX %data, dy 




lsll 




Is IX ea 




lsrb 


logical shift right 


IsrX dx,dy 




lsrw 




IsrX fdata, dy 




lsrl 




IsrX ea 




movb 


move data 


movX ea, ea 




movl 








movw 




movX %data, dn 




movw 


move from condition code register 


movw cc, ea 




movw 


move from status register 


movw s r ,ea 




move 


move to/from control register 


move rn, c r 








move c r, rn 




moveml 


move multiple registers 


movemX %mask, ea 




movemw 




movemX ea, %mask 
movemX ea,reglist 
movemX reglist, ea 




movepl 


move peripheral 


movepX dn, an@ ( d ) 




movepw 




movepX an@d,n ( d ) 




moveq 


move quick 


moveq %data, dn 




movsb 


move to/from address space 


movsX rn, ea 




movsw 




movsX ea, rn 




movsl 
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Table 6-7 List ofMC680x0 Instruction Codes — Continued 



Mnemonic 



Operation Name 



Syntax 



Processor 



signed multiply 


muls ea,dn 
mulsX ea,dl 
mulsX ea,dh:dl 


unsigned multiply 


mulu ea,dn 
muluX ea, d l 
muluX ea, dhzdl 


negate decimal with extend 


nbcd ea 


negate binary 


negX ea 


negate binary with extend 


negxX ea 


no operation 


nop 


logical complement 


notX ea 


inclusive or 


orX ea, dn 
orX dn, ea 
or %data,ea 

orb %data,cc 
orw %data,sr 


pack 


pack aX@-, ay@-, %data 
pack dX,dy, 4data 


push effective address 


pea ea 


reset device 


reset 


rotate left 


rolX dx, dy 


rotate left 


rolX %data, dy 
rolX ea 


rotate right 


rorX dx, dy 
rorX %data, dy 
rorX ea 


rotate left with extend 


roxlX dx, dy 
roxlX %data, dy 
roxlX ea 


rotate right with extend 


roxrX dx, dy 
roxrX %data, dy 
roxrX ea 


return and deallocate parameters 


rtd it data 



muls 

mulslw 

mulsll 



mulu 

mulul 




negxb 

negxw 

negxl 






pea 



reset 





roxlb 

roxlw 

roxll 



roxrb 

roxrw 

roxrl 
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Table 6-7 List ofMC680xQ Instruction Codes — Continued 



Mnemonic 


Operation Name 




Syntax 


Processor 




return from exception 


rte 








return from module 


rtm rn 


68020 




return and restore codes 


rtr 






rts 


return from subroutine 


rts 










rts 


#» 




sbcd 


subtract decimal with extend 


sbcd 


dy, dx 








sbcd 


ay©-, aX0- 




stop 


halt machine 


stop 


#xxx 




subb 


arithmetic subtract 


subX 


ea, d n 




subw 




subX 


d n, ea 








subX 


ea, an 




subl 




subX 


%data, ea 




st 


set all ones 


st 


ea 




sf 


set all zeros 


sf 


ea 




shi 


set high 


shi 


ea 




sis 


set lower or same 


sis 


ea 




see 


set carry clear 


see 


ea 




scs 


set carry set 


scs 


ea 




sne 


set not equal 


sne 


ea 




seq 


set equal 


seq 


ea 




SVC 


set no overflow 


SVC 


ea 




svs 


set on overflow 


svs 


ea 




spl 


set plus 


spl 


ea 




smi 


set minus 


smi 


ea 




sge 


set greater or equal 


sge 


ea 




sit 


set less than 


sit 


ea 




sgt 


set greater than 


sgt 


ea 




sle 


set less than or equal 


sle 


ea 




subqb 


subtract quick 


subqX %data,ea 




subqw 










subql 


subtract quick 








subxb 


subtract extended 


subxX dy , dx 




subxw 




subxX ay0-,aX0- 




subxl 










swap 


swap register halves 


swap 


dn 


* 


tas 


test operand then set 


tas 


ea 




trap 


trap 


trap 


% vector 




trapcc 


trap on carry clear 


trapccX 


68020 


t raped 




trapccX %data 


68020 


trapeew 








68020 


trapes 


trap on carry set 


trapesx 


68020 
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Table 6-7 List ofMC680x0 Instruction Codes — Continued 



Mnemonic 



t rape si 
trapesw 



trapeq 

trapeql 

trapeqw 



trapf 
trapfl 
trapf w 



trapge 

trapgel 

trapgew 



trapgt 

trapgtl 

trapgtw 



traphi 

traphil 

traphiw 



traple 

traplel 

traplew 



trapls 

traplsl 

traplsw 



traplt 

trapltl 

trapltw 



trapmi 

trapmil 

trapmiw 



trapne 

trapnel 

trapnew 



trappl 

trappll 

trapplw 



trapt 

traptl 

traptw 



Operation Name 



Syntax 



Processor 



trapcsX 4data 


68020 

68020 


trapeqX 


68020 


trapeqX 4 data 


68020 

68020 


trapfX 


68020 


trapfX 4data 


68020 

68020 


trapgeX 


68020 


trapgeX 4 data 


68020 

68020 


trapgtX 


68020 


trapgtl 4 data 


68020 

68020 


traphiX 


68020 


traphiXx # data 


68020 

68020 


trapleX 


68020 


trapleXx 4 data 


68020 

68020 


traplsX 


68020 


traplsx 4 data 


68020 

68020 


trapltX 


68020 


trapltx 


68020 

68020 


trapmiX 


68020 


trapmiX 4 data 


68020 

68020 


trapneX 


68020 


trapneX 4dala 


68020 

68020 


trappl 


68020 


trapplx 4 data 


68020 

68020 


trapt 


68020 


traptx 4data 


68020 

68020 


trapv 






trap on equal 



trap on never true 



trap on greater or equal 



trap on greater 



trap on hi 



trap on less or equal 



trap on low or same 



trap on less than 



trap on minus 
trap on minus 



trap on not equal 



trap on plus 



trap on always true 



trap on overflow 
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Table 6-7 List ofMC680x0 Instruction Codes — Continued 



Mnemonic 


Operation Name 


Syntax 


Processor 


trapvc 


trap on overflow clear 


trapvc 


68020 


trapvcl 

trapvcw 




trapvcx #data 


68020 

68020 


trapvs 


trap on overflow set 


trapvs 


68020 


trapvsl 

trapvsw 




trapvsx idata 


68020 

68020 


tstb 

tstw 

tstl 


test operand 


tstX ea 




unlk 


unlink 


unlk a n 




unpk 


unpack bed 


unpk aX@-,ay Q-,%data 
unpk 6X,dy,%data 


68020 

68020 



FPA Assembler Syntax — 
(New appendix) 



6.14. Instruction Syntax 



Page 79 

Append the following appendix at the end of the manual: 

This appendix describes the Floating-Point Accelerator (FPA) support extensions 
to as included in Sun software release 3. 1 and later. 

The extensions to as are described in general, with discussions of two-, three-, 
and four-operand instruction examples. Some instructions covered separately 
don’t follow the formats described at the beginning of the appendix. The appen- 
dix includes restrictions and potential errors, followed by a summary of sup- 
ported floating-point instructions. 



The general format for floating-point instructions is 



r~ 










fpoptQA 


operands 




L_ 






J 



where 

f p indicates an FPA instruction. 
op is the opcode name. 

t is the operand type, either single (s) or double (d). 

The @A part of the instruction is optional. When present, A specifies the address 
register which contains the base address for the FPA and can be in the range 0..7. 
If this form is used, a previous instruction must load the FPA address 
(OxeOOOOOOO) into the specified address register. 

If @A is not present, then absolute long addressing is used to refer to the FPA. 
This form is more efficient for short routines. 

Depending on the instruction, there may be from zero to four operands specified. 
The operands can be any of the following forms: 
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Any MC68020 effective address, with the exception that absolute short 
addresses are not allowed for double-precision values. 

If either of the data register or the address register is used to hold a double- 
precision value, then the value will be in a register pair and both registers, 

separated by a colon, must be specified in the instruction. For example: 


fpaddd dO:dl, fpaO 

■v 



6 . 15 , Register Syntax 



6.16. Operand Types 



6.17. Two-Operand 
Instructions 



The only exception to this rule is the fpltod instruction (convert integer 
to double-precision value). 

In some instructions (command register type) it is possible to specify that the 
register is in constant RAM. The syntax used for this case is %n, where n 
is a register number in the range 0 to 5 1 1. 

The 32 floating-point data registers are designated f paO , f pal , ..., 
fpa31. The supported control registers are: 



Hardware 


Software 


MODE3_0 


fpamode 


WSTATUS 


fpastatus 



as supports three floating-point operand types: 

□ s for single-precision operands. 

□ d for double-precision operands. 

□ 1 for 32-bit integer operands, used for integer to floating-point conversions. 



Opcodes such as add, subtract, multiply, divide, negate, absolute value, square 
root, conversion from integer to floating-point, conversion from single to double 
(and vice versa) are all represented as: 



r 


> 


X, fpa n 




V 


J 



where r= s or d, and X is any valid MC68020 effective address for an operand 
or is an FPA data register. 

If X is an FPA register which is in the constant RAM, then it can be in the range 
0 to 5 1 1 . If it is not in constant RAM, then it is one of the 32 FPA data registers. 
When X is an FPA register, then f pan is one of the 32 floating-point data regis- 
ters. If X is an effective address, then f pan is one of the FPA registers in the 
range 0 to 15. The following are examples of such instructions: 
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f 










Instruction 




Computes 


fpnegs 


<effective address>, 


fpal 




fpsqrd 


<effective address>. 


fpa2 




fpsubs 


fpal, fpa2 




fpa2 <- fpa2 - fpal 


fprsubs 


fpal, fpa2 




fpa2 <— fpal - fya2 


fpdivs 


dO, fpa2 




fpa2 fpa2 / dO 


fprdivs 


dO , f pa2 




fpa2 <- dO / fpa2 


L 






J 



In the above examples f pr subs and fprdivs are the reverse subtract and 
reverse divide operators, respectively. 



The opcodes for sine, cosine, atan, e~x, e~x -1, ln(x), 

In ( 1+x ) , sqrt ( x) , and s inco s ( x) are all supported as command register 
type instructions: 




where t = s or d. 



f pax is either a floating-point register or a register in the constant RAM (which 
is specified as %number). For the sincos instruction, the destination operand 
is actually a register pair: 




6.18. Three-Operand 
Instructions 



where fpac is the cosine’s destination and f pa s is the sine’s destination. 



The opcodes +, -, *, / are supported in extended and command register forms as 



r 




'v 


fpop3f 


X, fpa m, fpan 




V 




J 



where t = s or d and X is an <effective address>for an extended instruction or a 
floating-point register for a command register type of instruction. 

In the command register form, X and f pam can indicate a register number in the 
constant RAM. That is, they can either be in the range 0 to 5 1 1 or in the range 0 
to 31. In the extended instruction form, f pam and f pan must be in the range 
0 to 15. In the above format the position of X and f pam can be exchanged for 
the commutative operators add and multiply (the result of the operation remains 
the same). 



For example, 




can be represented by either of the following forms: 
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fpadd3s 


<effective address>, fpal. 


fpa2 






fpadd3s 


fpal, <effective address>. 


fpa2 












J 



The same rule applies to subtract and divide operations. However, they are not 
commutative, so different answers result from each order. For example, 




— 

fpa2 <effective address> - fpal 

s 



must be coded as: 




6.19. Four-Operand 
Instructions 



In the extended and command register formats there are pivot instructions of the 
form: 







tpopt X, fpax, fpay, fpan 




v 


J 



where f pan is the destination floating-point data register and t = s or d, and X 
is an effective address or a floating-point register. 

In the extended form, the positions of X and f pay can be exchanged for both 
single- and double-precision types of instructions. In single-precision extended 
form, it is possible for two of the four operands to be effective addresses. This is 
in general either the first and third or the second and third operands. 

In the command register form, f pax and f pay can be replaced by %x and %y 
indicating register numbers x and y in the constant RAM. 

For four-operand instructions, f pax, f pay and f pa n can each be in the range 
0 to 15, when X is an effective address. If X is an FPA register, then X and 
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f pan must be in the range 0 to 3 1 and f pax and f pay can either be in the 
range 0 to 5 1 1 (designating a location in constant RAM) or else in die range 0 to 
31. 

These pivot instructions are rather complicated and will be dealt with com- 
pletely. The following shows the forms of each operation, the assembly code 
equivalent to each form, a generalization of the assembly instruction and the 
sequence of operations equivalent to the pivot instruction. 



f 


Instruction 


Meaning 


— 


f pma { s , d } 


<effective address>, reg2, reg3, regl 


regl <r- reg3 + (reg2 * operand) 




fpma{s,d} 


reg2, reg3, <effective address>, regl 


regl <— operand + (reg3 * reg2) 




f pma { s , d } 


reg4, reg2, reg3, regl 


regl <- reg3 + (reg2 * reg4) 




fpmas 


<eal>, reg2, <ea2>, regl 


regl <- operand2 + (reg2 * operandl) 


j 



The f pma instruction, where m stands for multiply, and a stands for add, can 



be generalized as 




r 

fpmat X, fpax, fpay, fpan 


> 


V 


J 



where t is s or d, and X is an <effective address>or one of the floating-point 
data registers. In the extended type of instruction, the positions of X and fpay 
can be exchanged. Also, for single precision either the first and third operands or 
the second and third operands can be effective addresses. Note that, for example, 



f 

fpmas dO, 

s. 


fpal, fpa2, fpa3 


j 


is equivalent to the following sequence of instructions 








fpmul3s 


dO, fpal, temp 




fpadd3s 


temp, fpa2, temp 




fpmoves 


temp, fpa3 




V 







where temp is a temporary register. 



Instruction 



Meaning 



f pms { s , d } 
f pms { s , d } 
f pms { s , d } 
fpmss 



<effective address>, reg2, reg3, 
reg2, reg3, <effective address>, 
reg4, reg2, reg3, regl 
<eal>, reg2, <ea2>, regl 



regl 

regl 



regl <r- reg3 - (reg2 * operand) 
regl <r- operand - (reg3 * reg2) 
regl <r- reg3 - (reg2 * reg4) 
regl <— operand2 - (reg2 * operandl) 



The f pms instruction, where m stands for multiply, and s stands for subtract, 
can be generalized as 

— 
fpms/ X, fpax, fpay, fpan 

V 
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where t is s or d, and X is an <effective address> or one of the floating-point 
data registers. In the extended type of instruction, the positions of X and f pay 
can be exchanged. Also, in single-precision two-memory instructions, either the 
first and third operands or the second and third operands can be effective 
addresses. Note that, for example, 



fpmss fpal, fpa2, dO, fpa3 

V 



is equivalent to the following sequence of instructions 



— 

fpmul3s 


fpal. 


fpa2, temp 


\ 


fpsub3s 


temp. 


dO, temp 




fpmoves 


temp. 


fpa3 




v 






7 



The f pmr instruction, where m stands for multiply, and r stands for reverse 
subtract, can be generalized as 



f 






fpmrf 


X, fpax, fpay, fpa n 




V 




) 



where t is s or d, and X is an <effective address> or one of the floating-point 
data registers. In the extended type of instruction, the positions of X and fpay 
can be exchanged. 



( 


Instruction 


Meaning 


\ 


f pmr { s , d } 


<effective address>, reg2, reg3, regl 


regl <- (-reg3) + (reg2 * operand) 




f pmr { s , d } 


reg2, reg3, <effective address>, regl 


regl <- (-operand) + (reg3 * reg2) 




f pmr { s , d } 


reg4, reg2, reg3, regl 


regl <— (-reg3) + (reg2 * reg4) 




fpmrs 

•> 


<eal>, reg2, <ea2>, regl 


regl <- (-operand2) + (reg2 * operandl) 


J 



In single-precision extended form either the first and third operands or the second 
and third operands can be effective addresses. Note that, for example, 



r 

fpmrs dO, fpal, fpa2, fpa3 





v 2 


j 



is equivalent to the following sequence of instructions: 



r 




> 


fpmul3s 


dO, fpal, temp 




fpsub3s 


fpa2, temp, temp 




fpmoves 


temp, fpa 3 




v 




J 



The f pam instruction, where a stands for add, and m stands for multiply, can 
be generalized as 



r 


"1 


fpam t X, fpax, fpay, fpa/i 




V 


J 



where t is s or d, and X is an <effective address> or one of the floating-point 
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data registers. In the extended type of instruction, the positions of X and f pay 
can be exchanged. 



Instruction 



Meaning 



fpam{ s, d} 
fpam{s,d} 
fpam{s,d} 
fpams 



<effective address>, reg2, reg3, regl 
reg2, reg3, <effective address>, regl 
reg4, reg2, reg3, regl 
<eal>, reg2, <ea2>, regl 



regl <— reg3 * (reg2 + operand) 
regl «- operand * (reg3 + reg2) 
regl <- reg3 * (reg2 + reg4) 
regl «- operand2 * (reg2 + operandl) 



In single-precision two-memory instructions, either the first and third operands or 
the second and third operands can be effective addresses. Note that, for example, 




is equivalent to the following sequence of instructions: 



t 

fpadd3s 


fpal. 


fpa2. 


temp 


> 


fpmul3s 


temp. 


fpa3. 


temp 




fpmoves 


temp. 


fpa4 




j 



The f psm instruction, where s stands for subtract, and m stands for multiply, 
can be generalized as 



f psmf X, fpax, fpay, fpan 

s > 



where t is s or d, and X is an effective address or one of the floating-point data 
registers. In the extended type of instruction, the positions of X and fpay can 
be exchanged. The special cases for single-precision instructions are that either 
the first and third operands or the second and third operands can be effective 
addresses. 



— 




Instruction 


Meaning 




fpsm{s,d} 


<effective address>, reg2, reg3, regl 


regl <— reg3 * (reg2 - operand) 




fpsm{ s, d} 


reg2. 


reg3, <effective address>, regl 


regl <r- operand * (reg3 - reg2) 




fpsm{s,d} 


reg4. 


reg2, reg3, regl 


regl <- reg3 * (reg2 - reg4) 




fpsm{s,d} 


reg2. 


<effective address>, reg3, regl 


regl reg3 * (-reg2 + operand) 




fpsm{s,d} 


reg2. 


reg4, reg3, regl 


regl <r- reg3 * (-reg2 + reg4) 




fpsms 


<eal> 


, reg2, <ea2>, regl 


regl <— operand2 * (reg2 - operandl) 




fpsms 
^ 


reg2. 


<eal>, <ea2>, regl 


regl <- operand2 * (-ieg2 + operandl) 





Note that, for example, 



fpsms dO, fpal, fpa2, fpa3 

^ > 

is equivalent to the following sequence of instructions: 
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f 




\ 


fpsub3s 


dO, fpal, temp 




fpmul3s 


temp, fpa2, temp 




fpmoves 


temp, fpa3 








/ 



6.20. Other Instructions 



Other special instructions are listed below. In each of them the last operand is 
also the destination, except for tst, cmp and mcmp where fpastatus is 
the implied destination. X is either an effective address or an FPA data register 
and t is either s or d for all instructions except fpmover, where t can be s, 
d, or 1. 



Table 6-8 Other Instructions 



Mnemonic 


Syntax 


Operation Name 


fpnop 




nop 


fptstf 


X 


operand compare with zero 


fpcmpf 


X, fpam 


register m compare with operand 


fpmcmpf 


X, fpam 


register m compare magnitude with operand 


fpmovef 


fpam, fpan 


move floating-point registers 


fpmove 2f 


fpam, fpan 


2x2 matrix move 


fpmove 3f 


fp am, fpan 


3x3 matrix move 


fpmove 4f 


fpam, fpan 


4x4 matrix move 


fpdot2f 


fpax, f pay, fpan 


fpan <— f pax*fpay + 
(fpa x+1) * (tpay-fl) 


fpdot3f 


fpax, fpay, fpan 


fpan <— f pax* fpay + 
(fpax-fi) * (fpay-fl) + 
(fpax*2) * (fpay+2) 


fpdot4f 


fpax, fpay, fpan 


fpan <— f pax*^)ay + 

(fpax-fi)*(fpay+/) + (Q>ax+2)*(fpay-f2) + 
(fpax-f3)*(fpay+3) 


fptran2f 


fpam, fpan 


transpose 2x2 matrix 


fptran3f 


fpam, fpan 


transpose 3x3 matrix 


fptran4f 


fpam, fpan 


transpose 4x4 matrix 


fpmove 


fpamode, <ea> 


read mode register 


fpmove 


<ea> , fpamode 


write to mode register 


fpmove 


fpastatus, <ea> 


read status register 


fpmove 


<ea>, fpastatus 


write to status register 


fpmovef 


fpam, <ea> 


read a floating-point data register 


fpmovef 


<ea> , fpan 


write to a floating-point data register 
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6.21. Restrictions and 
Errors 



6.22. Instruction Set 
Summary 



In double-precision instructions, when absolute short addressing or a single data 
or address register is used, as reports an invalid operand error. 

For the dot product and matrix move and transpose instructions, when the regis- 
ter specified does not fall within the specified range, as reports a register out of 
range error. 

For most instructions where one operand is an effective address, the register 
range is 0 to 15. If all operands are FPA registers, then the register range is 0 to 
3 1 . For constant RAM registers, the range is 0 to 5 1 1 . as reports an invalid 
operand error when any of these registers are not within the permitted range. 

In the following table, X is any valid MC68020 effective address (the form 
( xxx ) : w is not allowed for double) or FPA register. In some three- or four- 
address instructions the position of the X and one of the FPA register can be 
exchanged. This is shown in the fourth column of the following table. 



Table 6-9 Floating-Point Instructions 



Instruction 


Syntax 


Operation 


Alternative 


fpnegs 


X, fpa n 


negate single 




fpnegd 


X, fpan 


negate double 




fpabss 


X, fpan 


absolute value single 




fpabsd 


X, fpan 


absolute value double 




fpltos 


X, fpan 


convert integer to single 




fpltod 


X, fpan 


convert integer to double 




fpstol 


X, fpan 


convert single to integer 




fpdtol 


X, fpan 


convert double to integer 




fpstod 


X, fpan 


convert single to double 




fpdtos 


X, fpan 


convert double to single 




fpsqrs 


X, fpan 


square single 




fpsqrd 


X, fpan 


square double 




fpadds 


X, fpan 


add single 




fpadd3s 


X, fpa m, fpan 


add single 


fpam, X, fpan 


fpaddd 


X, fpan 


add double 




fpadd3d 


X, fpam, fpan 


add double 


fpam, X, fpan 


fpsubs 


X, fpan 


subtract single 




fpsub3s 


X, fpam, fpan 


subtract single 


fpam, X, fpan 


fprsubs 


<ea>, fpan 


reverse subtract single 




fpsubd 


X, fpan 


subtract double 




fpsub3d 


X, fpam, fpan 


subtract double 


fpam, X, fpan 


fprsubd 


<ea>, fpan 


reverse subtract double 
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Table 6-9 Floating-Point Instructions — Continued 



Instruction 


Syntax 


Operation 


Alternative 


fpmuls 


X, fpan 


multiply single 




fpmul3s 


X, fpam, fpan 


multiply single 


fpam, X, fpan 


fpmuld 


X, fpan 


multiply double 




fpmul3d 


X, fpam, fpan 


multiply double 


fpam, X, fpan 


fpdivs 


X, fpan 


divide single 




f pdi v3 s 


X, fpam, fpan 


divide single 


fpam, X, fpan 


fprdivs 


<ea>, fpan 


reverse divide single 




fpdivd 


X, fpan 


divide double 




fpdiv3d 


X, fpam, fpan 


divide double 


fpam, X, fpan 


fprdivd 


<ea>, fpan 


reverse divide double 




fpnop 




nop 




fptsts 


X 


single compare with 0 




fptstd 


X 


double compare with 0 




fpcmps 


X, fpam 


single compare 




fpcmpd 


X, fpam 


double compare 




fpmcmps 


X, fpam 


single magnitude compare 




fpmcmpd 


X, fpam 


double magnitude compare 




fpsins 


fpax, fpan 


sine single 




fpsind 


fpax, fpan 


sine double 




fpcoss 


fpax, fpan 


cosine single 




fpcosd 


fpax, fpan 


cosine double 




f pat arts 


fpax, fpan 


atan single 




fpatand 


fpax, fpan 


atan double 




fpetoxs 


fpax, fpan 


e A x single 




fpetoxd 


fpax, fpan 


e"x double 




fpetoxmls 


fpax, fpan 


e~x-l single 




fpetoxmld 


fpax, fpan 


e A x-l double 




fplogns 


fpax, fpan 


In (x) single 




fplognd 


fpax, fpan 


ln(x) double 




fplognpls 


fpax, fpan 


In (1+x) single 




fplognpld 


fpax, fpan 


ln(l+x) double 




fpsincoss 


fpax, fpac:fpas 


fpac <— cosine (x), fpas <— sine(x) 




fpsincosd 


fpax, fpac: fpas 


fpac <— cosine (x) , fpas «- sine (x) 




fpmas 


X, fpax, fpay, fpan 


fpan <— (fpax * X) + fpay 










fpax, X, fpay, fpan 








fpay, fpax, X, fpan 








X, fpax, X, fpan 








fpax, X, X, fpan 


fpmad 


X, fpax, fpay, fpan 


fpan <— (fpax * X) + fpay 










fpax, X, fpay, fpan 
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Table 6-9 Floating-Point Instructions — Continued 



Instruction 


Syntax 


Operation 


Alternative 








fpay. 


fpax, X, fpan 


fpmss 


X, fpax, fpay, fpan 


fpan < — fpay - (fpax * X) 


fpax, 


X, fpay, fpan 








fpay, 


fpax, X, fpan 








X, fpax, X, fpan 








fpax. 


X, X, fpan 


fpmsd 


X, fpax, fpay, fpan 


fpan 4— fpay - (fpax * X) 


fpax. 


X, fpay, fpan 








fpay. 


fpax, X, fpan 


fpmrs 


X, fpax, fpay, fpan 


fpan 4- (fpax * X) - fpay 


fpax. 


X, fpay, fpan 








fpay. 


fpax, X, fpan 








X, fpax, X, fpan 








fpax. 


X, X, fpan 


fpmrd 


X, fpax, fpay, fpan 


fpan 4— (fpax * X) - fpay 


fpax. 


X, fpay, fpan 








fpay. 


fpax, X, fpan 


fpams 


X, fpax, fpay, fpan 


fpan 4- (fpax + X) * fpay 


fpax. 


X, fpay, fpan 








fpay. 


fpax, X, fpan 








X, fpax, X, fpan 








fpax. 


X, X, fpan 


fpamd 


X, fpax, fpay, fpan 


fpan 4- (fpax + X) * fpay 


fpax. 


X, fpay, fpan 








fpay. 


fpax, X, fpan 


fpsms 


X, fpax, fpay, fpan 


fpan 4- (fpax - X) * fpay 


fpax, 


X, fpay, fpan 








fpay. 


fpax, X, fpan 








X, fpax, X, fpan 








fpax. 


X, X, fpan 


fpsmd 


X, fpax, fpay, fpan 


fpan 4- (fpax - X) * fpay 


fpax. 


X, fpay, fpan 








fpay. 


fpax, X, fpan 


fpmoves 


<ea> , fpan 


write to a register, single 






fpmoved 


<ea> , fpan 


write to a register, double 






fpmovel 


<ea> , fpan 


write to a register, integer 






fpmoves 


fpam, <ea> 


read a register, single 






fpmoved 


fpa m, <ea> 


read a register, double 






fpmove2s 


fpam, fpan 


2x2 matrix move, single 






fpmove2d 


fpam, fpan 


2x2 matrix move, double 






fpmove3s 


fpam, fpan 


3x3 matrix move, single 






fpmove3d 


fpam, fpan 


3x3 matrix move, double 






fpmove4s 


fpam, fpan 


4x4 matrix move, single 






fpmove4d 


fpam, fpan 


4x4 matrix move, double 
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Table 6-9 Floating-Point Instructions — Continued 



Instruction 


Syntax 


Operation 


Alternative 


fpdot2s 


fpax, fpay, fpan 


fpan <— fpax* fpay + (fpa x+1) * (fpa y+1) 




fpdot2d 


fpax, fpay, fpan 


fpan «— fpax* fpay + (fpaxf-i) * (fpay-fi) 




fpdot3s 


fpax, fpay, fpan 


fpan <— fpax* fpay + (fpax-fi) * (fpa y+1) + 








(fpa x+2) * (fpa y+2) 




fpdot3d 


fpax, fpay, fpan 


fpan «- fpax* fpay + (fpax-f-7) * (fpa y+1) + 








(fpa x+2) * (fpay +2) 




fpdot4s 


fpax, fpay, fpan 


fpan <— fpax*fpay + (£pax+l) * (fpay-fi) + 








(fpax-f2) * (fpay-f2) + (fpax+3) * (fpay+3) 




fpdot4d 


fpax, fpay, fpan 


fpan <— fpax*fpay + (fpax-fi) * (fpay+i) + 








(£pax+2) * (fpay+2) + (fpax-f3) * (fpay-f5) 




fptran2s 


fpam, fpan 


transpose 2x2 matrix, single 




fptran2d 


fpam, fpan 


transpose 2x2 matrix, double 




fptran3s 


fpam, fpan 


transpose 3x3 matrix, single 




fptran3d 


fpam, fpan 


transpose 3x3 matrix, double 




fptran4s 


fpam, fpan 


transpose 4x4 matrix, single 




fptran4d 


fpam, fpan 


transpose 4x4 matrix, double 




fpmove 


fpamode, <ea> 


read the mode register 




fpmove 


<ea> , fpamode 


write on mode register 




fpmove 


fpastatus, <ea> 


read the status register 




fpmove 


<ea>, fpastatus 


write to status register 
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WHEREIS ( 1 ) 



USER COMMANDS 



WHEREIS ( 1 ) 



NAME 

whereis - locate source, binary, and/or manual for program 
SYNOPSIS 

whereis [ -sbm ] [ -u ] [ -BMS dir . . . -f ] filename . . . 

DESCRIPTION 

whereis locates source/binary and manuals sections for specified files. The supplied names are first 
stripped of leading pathname components and any (single) trailing extension of the form .ext, for example, 
.c. Prefixes of s. resulting from use of source code control are also dealt with, whereis then attempts to 
locate the desired program in a list of standard places: 

/bin 

lusr/bin 

/ usr/5bin 

/usr/games 

/ usr/hosts 

/ usr/include 

lusr/local 

/usr/etc 

lusr/lib 

hisr/man 

/usr/src 

/ usr/ucb 

OPTIONS 

-b Search only for binaries. 

-s Search only for sources. 

-m Search only for manual sections. 

-u Search for unusual entries. A file is said to be unusual if it does not have one entry of each 

requested type. Thus whereis -m -u * asks for those files in the current directory which have 
no documentation. 

-B Change or otherwise limit the places where whereis searches for binaries. 

-M Change or otherwise limit the places where whereis searches for manual sections. 

-S Change or otherwise limit the places where whereis searches for sources. 

-f Terminates the last directory list and signals the start of file names, and must be used when any of 

the -B, -M, or -S options are used. 

EXAMPLE 

Find all files in lusr/bin which are not documented in /usr/man/manl with source in /usr/src/ cmd : 
angel% cd /usr/ucb 

angel% whereis -u -M /usr/man/manl -S /usr/src/cmd -f * 

FILES 

/usr/src/* 

/usr/{doc,man}/* 

/lib, /etc, /usr/{lib, bin, ucb,old,new, local} 

BUGS 

Since whereis uses chdir( 2) to run faster, pathnames given with the -M, -S, or -B must be full; that is, 
they must begin with a 7\ 
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WHICH ( 1 ) 



USER COMMANDS 



WHICH ( 1 ) 



NAME 

which - locate a program file, including any aliases or paths 
SYNOPSIS 

which [ command ] . . . 

DESCRIPTION 

For each command argument given, which looks up the pathname of the file used to execute that command. 
If there is an alias set for command (csh only), which displays its value. Otherwise, which searches for the 
pathname along your search path. 

DIAGNOSTICS 

A diagnostic is given for names which are aliased to more than a single word, or if an executable file with 
the argument command was not found in the path. 
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LISTEN (2) 



SYSTEM CALLS 



LISTEN (2) 



NAME 

listen - listen for connections on a socket 

SYNOPSIS 

listen(s, backlog) 
int s, backlog; 

DESCRIPTION 

To accept connections, a socket is first created with socket ( 2), a backlog for incoming connections is 
specified with listen^ 2) and then the connections are accepted with accept (2). The listen call applies only 
to sockets of type SOCKSTRE AM or SOCK SEQPACKET. 

The backlog parameter defines the maximum length the queue of pending connections may grow to. If a 
connection request arrives with the queue full the client will receive an error with an indication of 
ECONN REFU SED . 

RETURN VALUE 

A 0 return value indicates success; -1 indicates an error. 

ERRORS 

The call fails if: 

EBADF The argument s is not a valid descriptor. 

ENOTSOCK The argument s is not a socket 

EOPNOTSUPP The socket is not of a type that supports the operation listen . 

SEE ALSO 

accept(2), connect(2), socket(2) 

BUGS 

The backlog is currently limited (silently) to 5. 
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SYSTEM CALLS 



LSEEK(2) 



NAME 

lseek, tell - move read/write pointer 

SYNOPSIS 

#include <sys/file.h> 

#define L SET 0 /* set the seek pointer */ 

#define L_INCR 1 /* increment the seek pointer */ 

#define L XTND 2 /* extend the file size */ 

pos = Iseek(d, offset, whence) 

long pos; 

intd; 

long offset; 
int whence; 

DESCRIPTION 

The descriptor d refers to a file or device open for reading and/or writing, lseek sets the file pointer of d as 
follows: 

If whence is L_SET, the pointer is set to offset bytes. 

If whence is L_INCR, the pointer is set to its current location plus offset. 

If whence is L_XTND, the pointer is set to the size of the file plus offset. 

Upon successful completion, the resulting pointer location as measured in bytes from beginning of the file 
is returned. Some devices are incapable of seeking. The value of the pointer associated with such a device 
is undefined. 

The obsolete function tellffildes) is identical to lseek(fildes, OL, L INCR). 

NOTES 

Seeking far beyond the end of a file, then writing, creates a gap or “hole”, which occupies no physical 
space and reads as zeros. 

RETURN VALUE 

Upon successful completion, a non-negative (long) integer, the current file pointer value, is returned. Oth- 
erwise, a value of-1 is returned and errno is set to indicate the error. 

ERRORS 

lseek will fail and the file pointer will remain unchanged if: 

EBADF Fildes is not an open file descriptor. 

ESPDPE Fildes is associated with a pipe or a socket 

EINVAL whence is not a proper value. 

SEE ALSO 

dup(2), open(2V) 
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MOUNT (3R) 



NAME 

mount - keep track of remotely mounted filesystems 
SYNOPSIS 

#include <rpcsvc/mount.h> 

RPC INFO 

program number 

MOUNTPROG 

xdr routines: 

xdr_exportbody(xdrs, ex) 

XDR *xdrs; 
struct exports *ex; 
xdr_exports(xdrs, ex); 

XDR *xdrs; 
struct exports **ex; 
xdr_fhandle(xdrs, fh); 

XDR *xdrs; 
fhandle_t *fp; 
xdr_fhstatus(xdrs, fhs); 

XDR *xdrs; 
struct fhstatus *fhs; 
xdrj>roups(xdrs, gr); 

XDR *xdrs; 
struct groups *gr; 
xdr_mountbody(xdrs, ml) 

XDR *xdrs; 
struct mountlist *ml; 
xdr_mountlist(xdrs, ml); 

XDR *xdrs; 
struct mountlist **ml; 
xdrjpath(xdrs, path); 

XDR *xdrs; 
char **path; 

procs: 

MOUNTPROCMNT 

argument of xdr_path, returns fhstatus. 
Requires unix authentication. 
MOUNTPROCDUMP 

no args, returns struct mountlist 
MOUNTPROCUMNT 

argument of xdrjpath, no results, 
requires unix authentication. 
MOUNTPROCUMNTALL 

no arguments, no results, 
requires unix authentication, 
umounts all remote mounts of sender. 
MOUNTPROCEXPORT 
MOUNTPROCEXPORT ALL 

no args, returns struct exports 

versions: 

MOUNTVERS_ORIG 

structures: 
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RPC SERVICES 



MOUNT (3R) 



struct mountlist { /* what is mounted */ 

char *ml_name; 
char *ml_path; 
struct mountlist *ml_nxt; 

}; 

struct fhstatus { 

int fhsstatus; 
fhandlet fhsfh; 



* List of exported directories 

* An export entry with ex_groups 

* NULL indicates an entry which is exported to the world. 
*/ 



struct exports { 



devt 


ex_dev; 


/* 


char 


*ex_name; 


/* 


struct groups 


*ex_groups; 


/* 


struct exports 


*ex_next; 




struct groups { 


char 


*g_name; 




struct groups 


*g_next; 





dev of directory */ 

name of directory */ 

groups allowed to mount this entry *1 



}; 



SEE ALSO 

mount(8), showmount(8), mountd(8C), 

NFS Protocol Spec , in Networking on the Sun Workstation. 
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Files to be Saved 



1. Standalone Systems 

/ . login 

/ . cshrc 

/ . rhosts 

/etc/passwd 

/etc/exports 

/etc/printcap 

/etc/fstab 

/etc/hosts .equiv 

/etc/dumpdates 

/etc/dump 

/etc/hosts 

/etc/rc . local 

/etc/rc .boot 

/etc/ttytype 

/etc/ttys 

/usr/lib/crontab 

/usr/ lib/ sendmail . cf 

2. Servers 

/ . login 
/ .cshrc 
/ . rhosts 
/etc/passwd 
/etc/exports 
/etc/printcap 
/etc/fstab 
/etc/hosts .equiv 
/etc/dumpdates 
/etc/dump 
/etc/hosts 
/etc/nd. local 
/etc/rc .boot 
/etc/rc . local 
/etc/ttytype 
/etc/ttys 

/usr/hosts/MAKEHOSTS 

/private/usr/lib/crontab 
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/private/usr/lib/sendmail .cf 

3. Diskless Clients 

/ . login 
/ . cshrc 
/ . rhosts 
/etc/passwd 
/etc/printcap 
/etc/f stab 
/etc/hosts .equiv 
/etc/hosts 
/etc/rc. local 
/etc/rc .boot 

/private/usr/lib/crontab 
/private/usr/lib/sendmail . cf 



In addition to the files listed above, the following files will be saved if your sys- 
tem is a YP master or a non YP machine. 

4. YP Masters And Non YP Machines 

/etc/ethers 

/etc/netgroup 

/etc/services 

/etc/protocols 

/etc/servers 

/etc/group 

/etc/networks 

/etc/ rpc 

/usr/ lib/aliases 

/usr/etc/yp/domain/* (for yp masters only) 

If your system is a YP slave server, all the YP maps under 
/usr/etc/yp/domain will be saved. 

5. YP Slave Servers 

/usr/etc/yp/domain/* 
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The following is the optional software available in the 3.2 release. 

NETWORKING: 

/usr/bin/traf f ic 
/usr/bin/ypcat 
/usr/bin/ypmatch 
/usr/bin/yppasswd 
/usr/bin/ypwhich 
/usr/etc/etherf ind 
/usr/ etc/ in . ftpd 
/usr/etc/in. rexecd 
/usr/etc/in. rwhod 
/usr/etc/in. telnetd 
/usr/ etc/ in . tf tpd 
/usr/etc/in. timed 
/usr/etc/nf sstat 
/usr/etc/ping 
/usr/etc/rarpd 
/usr/ etc/route 
/usr/etc/rpc .etherd 
/usr/etc/rpc .mountd 
/usr/etc/rpc . rquotad 
/usr/etc/rpc . rusersd 
/usr/etc/rpc . rwalld 
/usr/etc/rpc . sprayd 
/usr/etc/rpc .yppasswdd 
/usr/etc/rpcinfo 
/usr/etc/rwall 
/usr/etc/showmount 
/usr/etc/spray 
/usr/etc/yp/ 

/usr/etc/yp/makedbm 
/usr/etc/yp/yppush 
/usr/etc/yp/ypset 
/usr/etc/yp/ypxf r 
/usr/etc/yp/yppoll 
/usr/etc/yp/stdhosts 
/usr/etc/yp/ypinit 
/usr/etc/yp/ypxf r_lperday 
/usr/etc/yp/ypxf r_2perday 
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/usr/etc/yp/ypxf r_lperhour 

/usr/etc/yp/revnetgroup 

/usr/etc/yp/Makef ile 

/usr/etc/ypserv 

/usr/ucb/ftp 

/usr/ucb/netstat 

/usr/ucb/ rep 

/usr/ueb/rdate 

/ usr/ucb/ rdist 

/usr/ucb/rlogin 

/usr/ucb/ rsh 

/usr/ucb/ rup 

/usr/ucb/ r up t ime 

/usr/ueb/rusers 

/usr/ueb/rwho 

/usr/ucb/telnet 

/usr/ucb/tftp 

DEBUGGING 

/usr/lib/adb/adbgenl 

/usr /lib/adb/adbgen3 

/usr/lib/adb/adbgen4 

/usr/lib/adb/adbgen 

/usr/lib/adb/buf 

/usr/lib/adb/callout 

/usr/lib/adb/callout .nxt 

/usr/lib/adb/cblock 

/usr/lib/adb/cblock.nxt 

/usr/lib/adb/clist 

/usr/lib/adb/dino 

/usr/lib/adb/dir 

/usr/lib/adb/dir .nxt 

/usr/ lib/adb/ file 

/usr/lib/adb/f ilsys 

/usr /lib/adb/ if net 

/usr /lib/adb/ inode 

/usr/lib/adb/inpcb 

/usr/lib/adb/iovec 

/usr/ lib/adb/ ipreass 

/usr/lib/adb/ipreass .nxt 

/usr/lib/adb/mact 

/usr/lib/adb/mact .nxt 

/usr/lib/adb/xnbstat 

/usr/lib/adb/inbuf 

/usr/lib/adb/mbuf .nxt 

/usr/lib/adb/mbuf s 

/usr/lib/adb/mbuf s .nxt 

/usr/lib/adb/mount 

/usr/lib/adb/pcb 

/usr/lib/adb/proc 

/usr/lib/adb/protosw 

/usr/ lib/adb/ raweb 
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/usr/lib/adb/rtentry 

/usr/lib/adb/rusage 

/usr/lib/adb/setproc 

/usr/lib/adb/setproc .done 

/usr/lib/adb/setproc .nop 

/usr/lib/adb/setproc .nxt 

/usr/lib/adb/socket 

/usr/lib/adb/stat 

/usr/lib/adb/tcpcb 

/usr/lib/adb/tcpip 

/usr/lib/adb/tcpreass 

/usr/lib/adb/tcpreass .nxt 

/usr/ lib/adb/text 

/usr/lib/adb/traceall 

/usr/lib/adb/traceall .nxt 

/usr/lib/adb/tty 

/usr/lib/adb/u 

/usr/ lib/adb/ucred 

/usr/lib/adb/uio 

/usr/ lib/ adb/ vnode 

/usr/lib/adb/vtimes 

/usr/ lib/adb/adbsub . o 

/usr/bin/dbxtool 

SUNTOOLSUSERS 

/usr /bin/ adjacent screens 

/usr/bin/align_equals 

/usr /bin/capitalize 

/usr /bin/clear_f unctions 

/usr/bin/clock 

/usr/bin/clocktool 

/usr/bin/cmdtool 

/usr /bin/coretool 

/usr/bin/def aults_f rom_input 

/usr/bin/defaults_to_indentpro 

/usr/bin/defaults_to_mailrc 

/usr/bin/defaultsedit 

/usr /bin/ font edit 

/usr/bin/get_selection 

/usr/bin/gfxtool 

/usr/bin/iconedit 

/usr/bin/indentpro_to_defaults 

/usr/bin/input_f rom_defaults 

/usr/bin/ insert_brackets 

/usr/bin/lockscreen 

/usr/bin/lockscreen_default 

/usr/bin/mailrc_to_defaults 

/usr /bin/mailt ool 

/usr/bin/overview 

/usr /bin/per f meter 

/usr/bin/perfmon 

/usr/bin/ scrolldef aults 
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/usr/bin/selection_svc 

/ usr/bin/setkeys 

/usr/bin/shelltool 

/usr/bin/ shift_lines 

/usr/bin/stty_f rom_defaults 

/usr/bin/suntools 

/usr/bin/swin 

/usr /bin/switcher 

/usr/bin/tektool 

/usr /bin/text edit 

/usr/bin/othertools 

/ usr/bin/toolplaces 

/usr/bin/traf f ic 

/usr/demo/bouncedemo 

/usr/ demo / can va s_demo 

/usr/ demo / cur s o r_demo 

/us r / demo / f ramedemo 

/usr/ demo / j umpdemo 

/usr/ demo / sphe r e sdemo 

/usr/lib/defaults/Defaults . d 

/usr/lib/defaults/ Indent .d 

/usr/lib/def aults/input .d 

/usr/lib/defaults/Mail .d 

/usr/lib/def aults/Menu.d 

/usr/lib/def aults/Scrollbar . d 

/usr/lib/defaults/SunView.d 

/usr/lib/defaults/Text .d 

/usr /lib/defaults /Tty .d 

/usr/ lib/ fonts/ fixedwidthfonts /README 

/usr/lib/fonts/f ixedwidthfonts/apl . r . 10 

/usr/lib/ fonts/f ixedwidthfonts/cmr .b . 14 

/usr/lib/fonts/f ixedwidthf onts/cmr .b . 8 

/usr/lib/fonts/f ixedwidthfonts/cmr . r . 14 

/usr/lib/fonts/f ixedwidthfonts/cmr . r . 8 

/usr/lib/fonts/f ixedwidthf onts/cour .b . 10 

/usr/lib/fonts/f ixedwidthf onts/cour .b . 12 

/usr/lib/fonts/f ixedwidthf onts/cour .b . 14 

/usr/lib/f onts/f ixedwidthf onts/cour . r. 10 

/usr/lib/f onts/f ixedwidthf onts/cour . r. 12 

/usr/lib/fonts/f ixedwidthf onts/cour . r . 14 

/usr/lib/f onts/f ixedwidthf onts/gacha .b . 8 

/usr/lib/f onts/f ixedwidthf onts/gacha .b . 7 

/usr/lib/f onts/f ixedwidthf onts/gacha . r . 7 

/usr/lib/f onts/f ixedwidthf onts/gacha . r . 8 

/usr/lib/fonts/f ixedwidthf onts/gallant . r . 10 

/usr/lib/fonts/f ixedwidthf onts/gallant . r . 19 

/usr/lib/f onts/f ixedwidthf onts/ sail . r . 6 

/usr/lib/fonts/f ixedwidthf onts/screen .b . 12 

/usr/lib/f onts/f ixedwidthf onts /screen .b . 14 

/usr/lib/fonts/f ixedwidthf onts/screen . r . 11 

/usr/lib/fonts/f ixedwidthf onts/screen . r . 12 

/usr/lib/ fonts/f ixedwidthf onts/ screen . r . 13 

/usr/lib/fonts/f ixedwidthf onts/screen . r . 14 
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/usr/lib/f onts/f ixedwidthf onts/screen . r . 7 

/usr/ lib/f onts/f ixedwidthf onts/ serif . r . 10 

/usr/lib/fonts/f ixedwidthf onts/serif . r . 11 

/usr/lib/f onts/f ixedwidthf onts/ serif . r . 12 

/usr/lib/f onts/ f ixedwidthf onts /serif . r . 14 

/usr/lib/fonts/f ixedwidthfonts/serif . r . 16 

/usr / lib/f onts/tekfonts/tekf onto 

/usr/lib/fonts/tekfonts/tekfontl 

/usr / lib/f onts/tekfonts/tekfont2 

/usr/lib/fonts/tekfonts/tekfont3 

/usr/ lib/view_sur face 

/usr/lib/ . rootmenu 

/usr/lib/ . suntools 

/usr/ lib/ . textswrc 

SUNTOOLSPROGRAMMERS 

/usr/include/ images/* 

/usr /include/ sunt ool/* 

/usr/include/sunwindow/ * 

/usr/lib/libsuntool . a 
/usr/lib/libsunwindow.a 
/usr/lib/libtoolmerge . a 
/usr/src/sun/suntool/* 

SUNTOOLS_SOURCE 

/usr/src/sun/suntool/mailtool/main . o 
/usr/src/sun/suntool/mailtool/tool . o 
/usr/ src/sun/suntool/mailtool/ select ion . o 
/usr/src/sun/ suntool/mailtool/cmds . o 
/usr/src/sun/suntool/mailtool/mail . o 
/usr/ src/ sun/ sunt ool/mailt ool/ subr . o 
/usr/src/sun/suntool/mailtool/vars . o 
/usr/src/sun/suntool/iconedit/iconedit_canvas .c 
/usr/src/sun/suntool/iconedit/ iconedit_main . c 
/usr/src/sun/suntool/iconedit/iconedit_mpr . c 
/usr/src/sun/suntool/iconedit/iconedit_panel . c 
/us r / s rc / sun/ suntool / iconedit / iconedit_browse . c 
/usr/src/sun/ sunt ool/ iconedit/iconedit .h 
/usr/src/sun/ suntool/ iconedit /Makefile 
/usr/src/sun/suntool/Makef ile 
/usr/src/sun/ sunt ool /toolmerge . c 
/usr/src/sun/suntool/suntools .c 
/usr/src/sun/ suntool/ suntools_menu . c 
/usr/src/sun/suntool/selection_svc . c 
/usr/ src/sun/suntool/textedit . c 
/usr/ src/sun/suntool/view_surf ace . c 
/usr/src/sun/suntool/gfxtool . c 
/usr/src/sun/suntool/shelltool . c 
/usr/src/sun/suntool/cmdtool . c 
/usr/src/sun/suntool/clock . c 
/usr/src/sun/suntool/toolplaces .c 
/usr/src/sun/suntool/overview. c 
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/usr/src/sun/ suntool/tektool .c 
/usr/src/sun/suntool/canvas_demo . c 
/usr/src/sun/suntool/cursor_demo .c 
/usr/src/sun/suntool/ jumpdemo .c 
/usr/src/sun/suntool/spheresdemo . c 
/usr/src/sun/suntool/bouncedemo . c 
/usr/src/sun/suntool/ f ramedemo . c 
/usr/src/sun/suntool/perfmeter .c 
/usr/src/sun/suntool/meter .c 
/usr/src/sun/suntool/clockhands . c 
/usr/src/sun/suntool/clockhands . rom.c 
/usr/src/sun/suntool/swin.c 
/usr/src/sun/suntool/get_view_surface .c 
/usr/src/sun/suntool/ switcher .c 
/usr/src/sun/suntool/meter .h 
/usr/src/sun/suntool/clockhands .h 
/usr/src /sun/ sunt ool/basetools .h 
/usr/src/sun/suntool/othertools .h 

TEXTPROCESSING 

/usr/bin/addbib 
/usr/bin/derof f 
/usr/bin/eqn 
/usr/bin/indxbib 
/usr/bin/lookbib 
/usr/bin/neqn 
/usr/bin/nroff 
/usr/bin/ptx 
/usr /bin/ refer 
/usr/bin/rof fbib 
/usr/bin/sortbib 
/usr/bin/tbl 
/usr/bin/trof f 
/usr/lib/me/acm.me 
/usr/lib/me/chars .me 
/usr/lib/me/deltext .me 
/usr/lib/me/eqn.me 
/usr/lib/me/f loat .me 
/usr/lib/me/ footnote .me 
/usr/lib/me/index.me 
/usr/lib/me/local .me 
/usr/lib/me/null .me 
/usr/lib/me/refer .me 
/usr/lib/me/ revisions 
/usr/lib/me/sh .me 
/usr/lib/me/tbl .me 
/usr/lib/me/thesis .me 
/usr/lib/ms/ms .acc 
/usr/lib/ms/ms .cov 
/usr/lib/ms/ms .eqn 
/usr/lib/ms/ms . ref 
/usr/lib/ms/ms .tbl 
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/usr/lib/ms/ms .ths 
/usr/lib/ms/ms .toe 
/usr/ lib/ refer /hunt 
/usr/lib/refer/inv 
/usr/lib/refer/mkey 
/usr/lib/tmac/tmac .a 
/usr/lib/tmac/tmac .an 
/usr/lib/tmac/tmac. bib 
/usr/lib/tmac/tmac .cp 
/usr/ lib/tmac/tmac . e 
/usr/lib/tmac/tmac . imagen 
/usr/lib/tmac/tmac .os 
/usr/ lib/tmac/tmac . r 
/usr/ lib/tmac/tmac . s 
/usr/ lib/tmac/tmac . scover 
/usr/lib/tmac/tmac . sdisp 
/usr/lib/tmac/tmac . skeep 
/usr/ lib/tmac/tmac . sref s 
/usr/ lib/tmac/tmac . sun 
/usr/ lib/tmac/tmac . veat 
/usr/lib/tmac/tmac . vgrind 
/usr / lib/ vf ontedpr 
/usr/lib/vgrindef s 
/usr/ueb/vgrind 

SETUP 

/usr/etc/setup . files/setup . cards 
/usr/etc/setup . f iles/setuphardware . file 
/usr/etc/setup . f iles/xtr_root 
/usr/etc/setup . f iles/xtr_rootarch 
/usr/etc/setup . f iles/xtr_usrarch 
/usr/etc/setup . f iles/xtr_symlinks 
/usr/etc/setup. files/xtr_standalone 
/usr/etc/setup. files /xtr__standpub 
/usr/etc/setup . f iles/xtr_client 
/usr/etc/setup. files/copy_client 
/usr/etc/setup. f iles/f ix_client 
/usr/etc/setup. files /fix_hostname 
/usr/etc/setup. f iles/f ix_domainname 
/usr/etc/setup . f iles/f ix_rc .boot 
/usr/etc/setup. f iles/f ix_servers 
/usr/etc/setup. f iles/rootmenu 
/usr/etc/setup . files/setup . tty 
/usr/etc/setup. files/ setup. window 
/usr/etc/setup. files/setup. config 
/usr/etc/setup 

STANDDIAG 

/usr/ stand/ext ract_diags 
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FORTRAN 

/usr/bin/f77 
/usr/bin/ratfor 
/usr/include/f77/usercore77 .h 
/us r/ include /f 77/cgidefs77 .h 
/usr/lib/cg 
/usr/lib/f 1 
/usr/lib/f 77passl 
/usr/lib/iropt 
/usr/lib/libF77 .a 
/usr/lib/libI77 .a 
/usr/lib/libU77 .a 
/usr/lib/libcgi77 .a 
/usr/lib/libcore77 .a 
/usr/ucb/fpr 

USRDIAG 

/us r/diag/ loopback 

/usr/diag/vid. 120 .pat 

/usr/diag/sysdiag/ .cshrc 

/usr/diag/sysdiag/ . login 

/usr/diag/sysdiag/ . suntools 

/usr/diag/sysdiag/ .suntools-ipc 

/usr/diag/sysdiag/devtest 

/usr/diag/sysdiag/dcptest 

/usr / diag/ sysdiag/ skyprobe 

/usr/diag/sysdiag/probe 

/usr /diag/ sysdiag/ vmem 

/usr /diag/ sysdiag/pmem 

/usr/diag/sysdiag/disk 

/usr /diag/ sysdiag/gpmtest 

/us r /diag/ sysdiag/ sptest 

/us r /diag/ sysdiag/ reply 

/usr/diag/sysdiag/ cl 60 

/us r /diag/ sysdiag/ ipctest 

/usr/diag/ sysdiag/ f fpusr 

/usr /diag/ sysdiag/softfp 

/usr/diag/sysdiag/gpmtest . all . 2p 

/usr/diag/sysdiag/ gpmtest . allbutgb . 2p 

/usr/diag/sysdiag/gpmtest . f if o_vme . 2p 

/usr/diag/sysdiag/gpmtest . f if o_vme_dec . 2p 

/usr/diag/sysdiag/gpmtest . fpalu . 2p 

/usr/diag/sysdiag/gpmtest . fpmult . 2p 

/usr/diag/ sysdiag/memtop 

/usr/diag/sysdiag/gpmtest . fprega . 2p 

/usr/diag/ sysdiag/gpmtest . fpregb . 2p 

/usr/diag/sysdiag/gpmtest .gbnorm. 2p 

/usr/diag/sysdiag/gpmtest . gbrmw . 2p 

/usr/diag/sysdiag/gpmtest . int_f lag . 2p 

/usr/diag/ sysdiag/gpmtest .pp_29116 .2p 

/usr/diag/sysdiag/gpmtest .ppf ifo . 2p 

/usr/diag/sysdiag/gpmtest .ppprom.2p 
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/usr/diag/sysdiag/gpmtest . scrpad.2p 
/usr/diag/sysdiag/gpmtest . shmem. 2p 
/usr/diag/ sysdiag/gpmtest . vme_byte . 2p 
/usr/diag/sysdiag/gpmtest . vme_read. 2p 
/usr/diag/sysdiag/gpmtest . vme_read_byte . 2p 
/usr/diag/ sysdiag/gpmtest . vp_2 91 16 . 2p 
/usr/diag/ sysdiag/gpmtest . vpprom . 2p 
/usr/diag/sysdiag/gpmtest . xoperand . 2p 
/usr/diag/sysdiag/gpmtest .yoperand.2p 
/usr/diag/sysdiag/disktop 
/usr/diag/ sysdiag/dev 
/usr/diag/ sysdiag/tapetop 
/usr/diag/ sysdiag/devtop 
/usr/diag/sysdiag/setterm 
/usr/diag/ sysdiag/endt 
/usr/diag/sysdiag/sysdiag 
/usr/diag/sysdiag/ sysdiag.help 
/usr/diag/sysdiag/nextlog 
/usr/diag/sysdiag/ipctop 
/usr/ diag/ sysdiag/opt ions 

GRAPHICS 

/usr/bin/tek 
/usr/bin/t4013 
/usr/bin/t300 
/usr/bin/t300s 
/usr/bin/t450 
/usr/bin/aedplot 
/usr/bin/bgplot 
/usr/bin/crtplot 
/usr/bin/dumbplot 
/usr/bin/gigiplot 
/usr/bin/hpplot 
/usr/bin/vplot 
/usr/bin/plot 
/usr/include/cgicbind.h 
/usr/include/cgiconstants .h 
/usr/include/cgidef s .h 
/us r / include / cgipw . h 
/usr/include/usercore .h 
/usr/lib/libcgi . a 
/usr/lib/libcgi77 . a 
/usr/lib/libcore .a 
/usr/lib/libcore77 .a 
/usr/lib/libcorepas . a 
/usr/lib/libcoresky .a 
/usr/lib/libf 77plot .a 
/usr/lib/libplot .a 
/usr/lib/lib300 .a 
/usr/lib/lib300s .a 
/usr/lib/lib4013 .a 
/usr/lib/lib4014.a 
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/usr/lib/lib450 .a 
/usr/lib/libvtO .a 
/usr/lib/libplotaed.a 
/usr/lib/libplotbg. a 
/usr/lib/libplotdumb . a 
/usr/lib/libplotgigi .a 
/usr/lib/libplot2 648 .a 
/usr/lib/libplot7221 .a 
/usr/lib/libplotimagen.a 

PASCAL 

/usr/lib/how_pc 

/usr/lib/how_pi 

/usr/lib/how_pix 

/usr/lib/how_pxp 

/usr/lib/libpc.a 

/usr/lib/libpc_p . a 

/usr/lib/f 1 

/usr/lib/pcO 

/usr/lib/pc2 . il 

/usr/lib/pc3 

/usr/lib/pc3 . 5strings 

/usr/ lib/pcexterns . o 

/usr/lib/pi3 . 5strings 

/usr/lib/px_header 

/usr/ucb/pc 

/usr/ucb/pi 

/usr/ucb/pix 

/usr/ucb/pmerge 

/usr/ucb/px 

/usr/ucb/pxp 

/usr/ucb/pxref 

PROFILED 

/usr/lib/libF77_p .a 
/usr/lib/libI77_p . a 
/usr/lib/libU77_p .a 
/usr/ lib/libc^ p . a 
/usr/lib/libcurses_p . a 
/ u s r / 1 ib / 1 ibm_p . a 
/usr/lib/libpc_p.a 
/usr /lib/libpf c_p . a 
/usr/lib/libtermcap_p . a 
/usr/lib/libtermlib_p . a 

UUCP 

/usr /bin/uucp 

/usr/bin/uulog 

/usr/bin/uuname 

/usr/bin/uusend 

/usr/bin/uustat 
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/usr/bin/uux 

/usr/lib/uucp/uuxqt 

/usr/lib/uucp/uucico 

/usr/lib/uucp/uuclean 

/usr/lib/uucp/uusub 

/usr/lib/uucp/L-devices 

/usr/lib/uucp/L-dialcodes 

/usr/lib/uucp/L.cmds 

/usr/lib/uucp/L. sys 

/usr/lib/uucp/SEQF 

/usr/lib/uucp/USERFILE 

/usr/lib/uucp/uuck 

/usr/lib/uucp/uucp.day 

/us r / lib/uucp/uucp . hour 

/us r / lib/uucp/uucp . night 

/us r / lib/ uucp/uucp . noon 

/usr/lib / uucp/uucp . week 

/ usr/ lib/uucp/ uupoll 

/usr/spool/uucppublic/ . hushlogin 

/usr/ spool/uucp/C. // 

/usr/spool/uucp/D . // 

/usr/ spool/uucp/D .noname/ / 
/usr/spool/uucp/LOGFILE 
/usr/spool/uucp/OLD// 
/usr/spool/uucp/SYSLOG 

SYSTEMV 

/usr/5include/* 

/usr/51ib/* 

/usr/5bin/* 

/usr/bin/cf low 

/usr/bin/csplit 

/usr/bin/ctrace 

/usr/bin/cut 

/usr/bin/cxref 

/usr/bin/diffmk 

/usr/bin/dirname 

/usr/bin/getopt 

/usr/bin/id 

/usr/bin/logname 

/usr/bin/nl 

/usr/bin/pack 

/usr/bin/paste 

/usr/bin/pcat 

/usr/bin/sdiff 

/usr /bin/unpack linked to ./bin/pcat 

/usr/bin/ xargs 

/usr/ etc/de vnm 

/usr/etc/grpck 

/usr/etc/link 

/usr/etc/pwck 

/usr /etc/unlink 
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/ usr/lib/ctrace/ 

/usr/lib/ctrace/runtime .c 

/usr/lib/dag 

/usr/lib/f lip 

/usr/lib/lpfx 

/usr/lib/nmf 

/usr/lib/xpass 

MAN 

/usr/man/manl/* 

/usr/man/man2/* 

/usr/man/man3/* 

/usr/man/man4/* 

/usr/man/man5/* 

/usr/man/man6/* 

/usr/man/man7/* 

/usr/man/man8/* 

/usr/man/manl/* 

DEMO 

/ us r / demo / cur s o r_demo 
/ us r / demo / f r amedemo 
/usr/demo/ spheresdemo 
/usr/ demo/ canvas_demo 
/ u s r / demo / j umpdemo 
/usr /demo /bouncedemo 
/usr/demo/MAPS/ 

/usr /demo /MAPS /map. 1 
/usr/demo/MAPS/map .10 
/usr/demo /MAPS /map . 2 
/usr/demo/MAPS/map . 3 
/usr/demo/MAPS/map . 4 
/usr/demo/MAPS/map . 5 
/usr/demo/MAPS/map . 6 
/usr/demo/MAPS/map . 7 
/usr/demo/MAPS/map . 8 
/usr/demo/MAPS/map. 9 
/usr/demo/DATA/bottle . dat 
/usr/demo/DATA/egg.dat 
/usr/demo/DATA/glass .dat 
/usr/demo/DATA/icosa .dat 
/usr/demo/DATA/mtxs . rotob j 
/usr/demo/DATA/pyramid.dat 
/usr/demo /DATA/ rings . vecs 
/usr/demo/DATA/ shuttle . vecs 
/usr/demo/DATA/socbal . dat 
/usr/demo/DATA/ space.dat 
/usr/demo/DATA/ st ring. vecs 
/usr /demo /DATA/ testmol 
/usr/demo/DATA/vw . vecs 
/usr/demo/COLORPIX/colorimage . 1 
/usr/demo/COLORPIX/colorimage . 2 
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/usr/demo/SRC/draw.c 
/usr/demo/SRC/shaded.c 
/usr/demo/SRC/showmap . c 
/usr/demo/SRC/stringart . c 
/usr/demo/SRC/suncube . c 
/usr/demo/SRC/cf ramedemo . c 
/usr/demo/SRC/show.c 
/usr/demo/SRC/maze . c 
/usr/demo/SRC/rotob j .c 
/usr/demo/SRC/ flight . c 
/usr/demo/SRC/goban .c 
/usr/demo/SRC/goboard.c 
/usr/demo/SRC/gopanel . c 
/usr/demo/SRC/goservice . c 
/usr/demo/SRC/gocapture. c 
/usr/dexno/SRC/gocircle . c 
/usr/demo/SRC/goprint . c 
/usr/demo/SRC/demolib .h 
/usr/demo/SRC/f light_dat .h 
/usr/demo/SRC/goban. h 
/usr/demo/SRC/goban. icon 
/usr/demo/SRC/Makef ile 
/usr/demo/globef rames/f rame . 0 
/usr/demo/globef rames/f rame . 1 
/usr/demo/globef rames/f rame . 10 
/usr/demo/globef rames/f rame . 11 
/usr/demo/globef rames/f rame . 12 
/usr/demo/globef rames/f rame . 13 
/usr/demo/globef rames/f rame . 14 
/usr/demo/globef rames/f rame . 15 
/usr/demo/globef rames/f rame .16 
/usr/demo/globef rames/f rame . 17 
/usr/demo/globef rames/f rame . 18 
/usr/demo/globef rames/f rame . 19 
/usr/demo/globef rames/f rame .2 
/usr/demo/globef rames/f rame .20 
/usr/demo/globef rames/f rame .21 
/usr/demo/globef rames/f rame .22 
/usr/demo/globef rames/f rame .23 
/usr/demo/globef rames/f rame .24 
/usr/demo/globef rames/f rame .25 
/usr/demo/globef rames/f rame .26 
/usr/demo/globef rames/f rame .27 
/usr/demo/globef rames/f rame .28 
/usr/demo/globef rames/f rame .29 
/usr/demo/globef rames/f rame .3 
/usr/demo/globef rames/f rame .30 
/usr/demo/globef rames/f rame . 4 
/usr/demo/globef rames/f rame . 5 
/usr/demo/globef rames/f rame . 6 
/usr/demo/globef rames/f rame .7 
/usr/demo/globef rames/f rame . 8 
/usr/demo/globef rames/f rame . 9 
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/ u s r / demo / RE AD_ME 
/us r /demo /Readme .goban 
/usr /demo /maze 

GAMES 

/usr/games/lib/chess .book 
/usr/games/lib/crib. instr 
/usr/games/lib/fortunes -dat 
/usr/games/lib/hackdir/ 
/usr/games / lib/hackdir / data 
/usr/games/lib/hackdir /help 
/usr/games/ lib/hackdir /hh 
/usr/games/lib/hackdir/ rumors 
/usr /games /lib/hackdir /perm 
/usr/games/lib/hackdir/ record 
/usr/games/lib/cards .pck 
/usr /games /lib/backrules 
/usr/games/lib/ cf scores 
/usr/games /adventure 
/usr/ game s / ba c kgammon 
/usr/ games / teachgammon 
/usr/games /boggle 
/usr/games/bogdict 
/usr/games/chess 
/usr /games /cribbage 
/usr/games /fortune 
/usr/games /hack 
/usr/games /hangman 
/usr /games /chesstool 
/usr/games/gammontool 
/usr/games/boggletool 
/usr /games /canf ieldtool 
/usr/games /life 
/usr/games /gammonscore 
/usr /games /boggledict 
/usr/games /bed 
/usr/games /arithmetic 
/usr/games /btlgammon 
/usr/games /banner 
/usr/games/bj 
/usr/games /cf scores 
/usr/games /factor 
/usr/games /fish 
/usr/games /number 
/usr/games /random 
/ us r / game s / wump 
/usr/games/ canfield 
/usr /games /primes 

VTROFF 

/usr/bin/vplot 
/usr/lib/rveat 
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/usr/lib/rvsort 

/usr/lib/vcat 

/usr/lib/vdmp 

/usr/lib/vfontinfo 

/usr/lib/vfw 

/usr/lib/vpf 

/usr/lib/vpfW 

/usr/lib/vplotf 

/usr/lib/vpltdmp 

/usr/lib/vpsf 

/usr/lib/vpsfW 

/usr/lib/vsort 

/usr/lib/vswap 

/usr/lib/vwidth 

/usr/ucb/vtrof f 

/usr/lib/vfont/* 
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